> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Linkfox Chuhaijiang image upload URL

> Request a temporary upload URL using fileName (JPG, JPEG or PNG). After success, PUT the raw image bytes to data.url with the matching image Content-Type, without an AISA or Linkfox Authorization header. A PUT response of 200, 201 or 204 confirms upload. Then pass data.os_key as osKey to POST /apis/v1/linkfox/chuhaijiang/products/image-search. data.signed_url is a temporary read URL, never the PUT target. Treat signed URLs as temporary credentials; do not publish them. Successful URL issuance costs $0.001 even if you do not subsequently upload; failed issuance is not charged.

Issue a temporary image upload URL and os_key. USD 0.001 per successful issuance; failures are not charged. PUT the image to data.url before image search.

## Request contract

* **Method and path:** POST /apis/v1/linkfox/chuhaijiang/upload/presigned-url
* **Availability:** enabled
* **Request URL template:** `https://api.aisa.one/apis/v1/linkfox/chuhaijiang/upload/presigned-url`

[Complete OpenAPI definition](https://aisa.one/docs/openapi/linkfox.json)

Effective request declaration (including authentication and referenced schemas):

```json theme={null}
{
  "operationId": "post_linkfox_apis_v1_linkfox_chuhaijiang_upload_p_96881c",
  "method": "POST",
  "path": "/apis/v1/linkfox/chuhaijiang/upload/presigned-url",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "request": {
            "summary": "Illustrative request.",
            "value": {
              "fileName": "product.jpg"
            }
          }
        },
        "schema": {
          "additionalProperties": true,
          "properties": {
            "fileName": {
              "description": "Image filename including .jpg, .jpeg or .png extension.",
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "fileName"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```

## Cost and request rules

Published reference price: \$0.001 USD per successful request. Your account price may differ; use a request quote where supported.


## OpenAPI

````yaml openapi/linkfox.json POST /apis/v1/linkfox/chuhaijiang/upload/presigned-url
openapi: 3.1.0
info:
  description: ''
  title: Linkfox
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-catalogs:
    linkfox:
      description: ''
      title: Linkfox
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
      x-aisa-document:
        facts_hash: 9a2bdba0b6f6b4a5642eb74acc83887695be193596362bd6f1b4df92a685463c
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-configured-paths:
    - /apis/v1/linkfox/alibaba1688/imageSearch
    - /apis/v1/linkfox/alibaba1688/productDetail
    - /apis/v1/linkfox/amazon/product/detail
    - /apis/v1/linkfox/amazon/reviews/list
    - /apis/v1/linkfox/amazon/search
    - /apis/v1/linkfox/amazon/searchByImage
    - /apis/v1/linkfox/chuhaijiang/products/detail
    - /apis/v1/linkfox/chuhaijiang/products/image-search
    - /apis/v1/linkfox/chuhaijiang/products/search
    - /apis/v1/linkfox/chuhaijiang/upload/presigned-url
    - /apis/v1/linkfox/dld/productBillboard
    - /apis/v1/linkfox/dld/productSearch
    - /apis/v1/linkfox/echotik/batchProductDetail
    - /apis/v1/linkfox/echotik/batchVideoDetail
    - /apis/v1/linkfox/echotik/category/detail
    - /apis/v1/linkfox/echotik/category/l1
    - /apis/v1/linkfox/echotik/category/l2
    - /apis/v1/linkfox/echotik/category/l3
    - /apis/v1/linkfox/echotik/category/trend
    - /apis/v1/linkfox/echotik/influencer/detail
    - /apis/v1/linkfox/echotik/influencer/trend
    - /apis/v1/linkfox/echotik/listProduct
    - /apis/v1/linkfox/echotik/listProductVideo
    - /apis/v1/linkfox/echotik/listSeller
    - /apis/v1/linkfox/echotik/listSellerProduct
    - /apis/v1/linkfox/echotik/listVideo
    - /apis/v1/linkfox/echotik/listVideoRank
    - /apis/v1/linkfox/echotik/sellerDetail
    - /apis/v1/linkfox/geekbi/temu/categoryList
    - /apis/v1/linkfox/geekbi/temu/goodsDetail
    - /apis/v1/linkfox/geekbi/temu/goodsSearch
    - /apis/v1/linkfox/geekbi/temu/mallSearch
    - /apis/v1/linkfox/googleTrend/getTrendByKeys
    - /apis/v1/linkfox/jiimore/getNicheInfoByKeyword
    - /apis/v1/linkfox/kalodata/creator/rank
    - /apis/v1/linkfox/kalodata/product/rank
    - /apis/v1/linkfox/keepa/productSeries
    - /apis/v1/linkfox/sellersprite/market/statistics
    - /apis/v1/linkfox/sellersprite/productSearch
    - /apis/v1/linkfox/sif/asinKeywords
    - /apis/v1/linkfox/sif/keywordOverview
    - /apis/v1/linkfox/sif/keywordSummary
    - /apis/v1/linkfox/sorftime/walmart/keywordResearch
    - /apis/v1/linkfox/tool-jungle-scout/keywords/by-keyword
  x-aisa-document:
    composer_version: '31'
    document_hash: sha256:092818c29965ae64dea88205444fa3127e262c65cd9b1bf018c2ff27e9c33b0b
    facts_hash: 9a2bdba0b6f6b4a5642eb74acc83887695be193596362bd6f1b4df92a685463c
    generator_version: '3'
    protocol_version: '1'
    response_pending: []
    schema_version: '1'
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: linkfox
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/linkfox/chuhaijiang/upload/presigned-url:
    post:
      tags:
        - chuhaijiang
      summary: Linkfox Chuhaijiang image upload URL
      description: >-
        Request a temporary upload URL using fileName (JPG, JPEG or PNG). After
        success, PUT the raw image bytes to data.url with the matching image
        Content-Type, without an AISA or Linkfox Authorization header. A PUT
        response of 200, 201 or 204 confirms upload. Then pass data.os_key as
        osKey to POST /apis/v1/linkfox/chuhaijiang/products/image-search.
        data.signed_url is a temporary read URL, never the PUT target. Treat
        signed URLs as temporary credentials; do not publish them. Successful
        URL issuance costs $0.001 even if you do not subsequently upload; failed
        issuance is not charged.


        Issue a temporary image upload URL and os_key. USD 0.001 per successful
        issuance; failures are not charged. PUT the image to data.url before
        image search.
      operationId: post_linkfox_apis_v1_linkfox_chuhaijiang_upload_p_96881c
      requestBody:
        content:
          application/json:
            examples:
              request:
                summary: Illustrative request.
                value:
                  fileName: product.jpg
            schema:
              additionalProperties: true
              properties:
                fileName:
                  description: Image filename including .jpg, .jpeg or .png extension.
                  minLength: 1
                  type: string
              required:
                - fileName
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              examples:
                illustration:
                  summary: >-
                    Illustrative structure; these example URLs cannot be used
                    for uploads.
                  value:
                    data:
                      os_bucket: example
                      os_key: upload/product.jpg
                      signed_url: https://read.example.invalid/upload/product.jpg
                      url: https://upload.example.invalid/upload/product.jpg
                    errcode: 200
                    errmsg: ok
                    request_id: example
              schema:
                additionalProperties: true
                description: >-
                  Provider JSON response. Optional fields can be omitted;
                  additional provider fields are preserved. This schema
                  documents the HTTP body, excluding client-added
                  costToken/costCredit and local cache fields.
                properties:
                  data:
                    additionalProperties: true
                    properties:
                      os_bucket:
                        description: Storage bucket.
                        type: string
                      os_key:
                        description: Use as image-search osKey after the PUT succeeds.
                        type: string
                      signed_url:
                        description: >-
                          Temporary read URL; do not use it as the upload
                          target.
                        type: string
                      url:
                        description: >-
                          Temporary PUT upload URL. Upload raw image bytes here
                          without API authorization.
                        type: string
                    type: object
                  errcode:
                    description: 网关业务状态码；成功示例值为 200，判断遵循公共规则
                    type:
                      - integer
                      - string
                      - 'null'
                  errmsg:
                    description: 消息，成功时为 `ok`
                    type: string
                  request_id:
                    description: 请求追踪 ID
                    type: string
                type: object
          description: Provider response; inspect the business status in the body.
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.