智能绘图统一接口

接口说明为了方便开发者调用不同的图像生成模型，PoloAPI 提供了统一的图形接口，支持以下多种主流模型：

接口规格：

Curl

Copy

curl https://poloai.top/models/<model_path>/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "your prompt"
  }
}'

其中：

https://poloai.top/models/ 为固定前缀
<model_path> 为模型路径，支持：
- opanai/gpt-image-1
- opanai/dall-e-3
- imagen-4.0-ultra-generate-preview-06-06
- imagen-4.0-generate-preview-06-06
- imagen-4.0-ultra-generate-exp-05-20
- imagen-4.0-generate-preview-05-20
- imagen-3.0-generate-002
- flux-kontext-max
- flux-kontext-pro
- ideogram/V3
- stability/Stable-Diffusion-3-5-Large
sk-*** 为你在 PoloAPI 生成的 API Key

下面是各个模型的调用方法。

OpenAI

支持的模型：

gpt-image-1
dall-e-3

不支持 2 个逆向模型 gpt-4o-image-vip 和 gpt-4o-image

调用方法：

Curl gpt-image-1

Curl dall-e-3

Copy

curl https://poloai.top/models/opanai/gpt-image-1/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "size": "1024x1024", 
    "n": 1,
    "quality": "high",
    "moderation": "low",
    "background": "auto"
  }
}'

Google Imagen

支持的模型：

imagen-4.0-ultra-generate-preview-06-06
imagen-4.0-generate-preview-06-06
imagen-4.0-ultra-generate-exp-05-20
imagen-4.0-generate-preview-05-20
imagen-3.0-generate-002

不支持 gemini 系列

调用方法：

Curl

Copy

curl https://poloai.top/models/google/imagen-3.0-generate-002/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "numberOfImages": 1
  }
}'

Flux

支持的模型：

flux-kontext-max
flux-kontext-pro

flux 系列均为异步端口，需要分 2 步请求
速度极快，几乎秒出
flux-Kontext-max 支持文生图和参考图生图，flux-kontext-pro 端口只支持文生图
画幅比例 aspect_ratio 支持的范围是：21:9 到 9:21
审核宽松度参数 safety_tolerance 范围在 0 到 6 之间0 表示最严格6 表示最宽松。使用参考图时限制为 2。
参考图支持 URL 或 Base64 格式，推荐采用前者
更多细节参考：FLUX API Reference

调用方法：第一步：发出绘图请求

Curl flux-kontext-max 文生图

Curl flux-kontext-max 图生图

Curl flux-kontext-pro 文生图

Copy

curl https://poloai.top/models/bfl/flux-kontext-max/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace. reference style as the given image:",
    "aspect_ratio": "2:3",
    "safety_tolerance": 6
  }
}'

输出结果示例：

Copy

{"output":[{"polling_url":"https://api.us1.bfl.ai/v1/get_result?id=f9821dbf-f134-41c2-aaa8-5405fb665c76","taskId":"api.us1.***"}]}%

第二步：获取生成的图片链接tasks/ 后面的字符串替换成第一步获取的 taskId：

获取图片

Copy

curl https://api.poloai.top/tasks/api.us1.bfl.*** \
    -H "Authorization: Bearer sk-***" \
    -X GET

Ideogram V3

支持的模型：

V3

V3 以下版本（V_2、V_1 等）为旧接口，暂不支持
返回的链接需要打开代理网络才能获取

调用方法：

Curl

Copy

curl https://poloai.top/models/ideogram/V3/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace, in the style of Pixar 3D",
    "rendering_speed": "QUALITY",
    "aspect_ratio": "2x1"
  }
}'

Stability

支持的模型：

Stable-Diffusion-3-5-Large

调用方法：

Curl

Copy

curl https://poloai.top/models/stability/Stable-Diffusion-3-5-Large/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
    "n": 1
  }
}'