Nội dungĐọc hình ảnh
返回文档

图像、音频与视频

检查格式与任务生命周期。

发送图像、音频或视频前请检查模型能力。异步视频任务应保存任务 ID 并查询状态；响应中断后不要自动重新创建任务。

读取图像

标记为 Vision 的模型接收 PNG/JPEG/WebP/GIF 图像。通过 Anthropic Messages 向 Claude 小组发送与问题相同的内容字段中的 Base64 图像：

curl https://apivn.dev/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 512,
    "messages": [{
      "role": "user",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="
          }
        },
        {"type": "text", "text": "描述一下这张照片的内容"}
      ]
    }]
  }'

16 GPT 模型直接在 /v1/chat/completions 处使用 OpenAI 标准 image_url。中转网关支持 base64 数据 URL 和 http 图像 URL：

{
  "model": "gpt-5.6-sol",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "阅读此照片内容"},
      {
        "type": "image_url",
        "image_url": {"url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="}
      }
    ]
  }]
}

提供商返回的图像token将被记录并作为输入token收费。建议在发送前对图片进行压缩，并将整个请求内容保持在 20 MB 限制以下。

图像、音频与视频

生成与编辑图像

了解图像生成、参考图像、结果处理及费用的 JSON 接口。

查看完整指南

/v1/images/generations

curl https://apivn.dev/v1/images/generations \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "a tiny red circle on white",
    "size": "1024x1024",
    "n": 1
  }'

/v1/images/edits

curl https://apivn.dev/v1/images/edits \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "keep the same subject, soft studio lighting",
    "image": "https://example.com/reference.png",
    "size": "1024x1024",
    "n": 1
  }'

# image / image_url / reference_image / ref_image:
# data URL, base64 thuần, hoặc URL http(s) công khai
视频生成

示例经过源码审查和本地检查，不代表已验证每个应用版本。正式使用前请检查设置、发送小型请求并确认用量。

Support