上传图片

上传图片

curl --request POST \
  --url https://api.ch88.cn/v1/open/uploads/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file \
  --form model=gpt-image-2

import requests

url = "https://api.ch88.cn/v1/open/uploads/images"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "model": "gpt-image-2" }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('model', 'gpt-image-2');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.ch88.cn/v1/open/uploads/images', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 201,
  "data": {
    "id": "generated/open-upload/550e8400-e29b-41d4-a716-446655440000.png",
    "url": "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2F550e8400-e29b-41d4-a716-446655440000.png",
    "expiresAt": "2026-09-15T08:30:00.000Z"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "不支持或损坏的图片文件",
    "details": {
      "upstream_code": "INVALID_IMAGE_FILE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 413,
    "type": "invalid_request_error",
    "message": "gpt-image-2 图片大小必须在 1 字节到 20971520 字节之间",
    "details": {
      "upstream_code": "FILE_TOO_LARGE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

POST

https://api.ch88.cn

open

uploads

images

上传图片

curl --request POST \
  --url https://api.ch88.cn/v1/open/uploads/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file \
  --form model=gpt-image-2

import requests

url = "https://api.ch88.cn/v1/open/uploads/images"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "model": "gpt-image-2" }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('model', 'gpt-image-2');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.ch88.cn/v1/open/uploads/images', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 201,
  "data": {
    "id": "generated/open-upload/550e8400-e29b-41d4-a716-446655440000.png",
    "url": "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2F550e8400-e29b-41d4-a716-446655440000.png",
    "expiresAt": "2026-09-15T08:30:00.000Z"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "不支持或损坏的图片文件",
    "details": {
      "upstream_code": "INVALID_IMAGE_FILE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 413,
    "type": "invalid_request_error",
    "message": "gpt-image-2 图片大小必须在 1 字节到 20971520 字节之间",
    "details": {
      "upstream_code": "FILE_TOO_LARGE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": 201,
  "data": {
    "id": "generated/open-upload/550e8400-e29b-41d4-a716-446655440000.png",
    "url": "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2F550e8400-e29b-41d4-a716-446655440000.png",
    "expiresAt": "2026-09-15T08:30:00.000Z"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "不支持或损坏的图片文件",
    "details": {
      "upstream_code": "INVALID_IMAGE_FILE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 413,
    "type": "invalid_request_error",
    "message": "gpt-image-2 图片大小必须在 1 字节到 20971520 字节之间",
    "details": {
      "upstream_code": "FILE_TOO_LARGE"
    }
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

授权

Authorization

string

header

必填

成员级 Public API Key。请填写完整密钥，Mintlify Playground 会自动以 Authorization: Bearer <PUBLIC_API_KEY> 发送。完整明文只在管理后台创建成功时显示一次。

请求体

multipart/form-data

file

必填

图片文件。支持 PNG、JPEG、WebP、GIF、AVIF，实际大小上限由 model 决定。

model

enum<string>

默认值:gpt-image-2

目标生图模型。省略时按 gpt-image-2 的 20 MB 上限校验。

可用选项:

gpt-image-2,

nano-banana-2-lite,

nano-banana-2,

nano-banana-pro

响应

图片上传成功。

code

integer

必填

HTTP 状态码。成功上传时为 201

示例:

201

data

object

必填

Hide child attributes

data.id

string

必填

R2 中的临时图片资源标识。通常不需要自行使用该值。

示例:

"generated/open-upload/550e8400-e29b-41d4-a716-446655440000.png"

data.url

string<uri>

必填

图片临时公开访问地址，可直接传入后续接口的 image_urls，最长有效 3 天。

data.expiresAt

string<date-time>

必填

图片预计过期时间，ISO 8601 UTC 格式。到期后图片可能被自动清理。

request_id

string

必填

本次请求的诊断编号。联系平台排查问题时请提供，不要记录 Public API Key。

示例:

"req_550e8400-e29b-41d4-a716-446655440000"

接口概览

全部接口

授权

请求体

响应