Developer API / Image

图片生成 API

支持同步生成与异步任务两种调用方式，并可通过公网图片 URL 进行图生图、角色参考和图片编辑。

POST /v1/images/generationsPOST /v1/videosBearer Auth

选择调用方式

同步生成POST /v1/images/generations

等待生成完成后一次返回图片数据，接入最简单。

异步生成POST /v1/videos

立即返回任务 ID，再轮询查询。适合 2K/4K 或批量后台任务。

Base URL：https://api1.link-ai.cc/v1。API Key 格式示例：sk-xxxxxxxx。

异步图片生成

POSThttps://api1.link-ai.cc/v1/videos

curl -X POST "https://api1.link-ai.cc/v1/videos" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-2K",
    "prompt": "retro neon poster, cyberpunk girl",
    "seconds": "4",
    "aspect_ratio": "9:16"
  }'

带参考图

curl -X POST "https://api1.link-ai.cc/v1/videos" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nana-banana-pro-4k",
    "prompt": "keep the character identity, place her in a futuristic city",
    "seconds": "4",
    "images": ["https://your-cdn.com/reference.jpg"],
    "aspect_ratio": "16:9"
  }'

查询异步任务

GEThttps://api1.link-ai.cc/v1/videos/{task_id}

curl "https://api1.link-ai.cc/v1/videos/task_xxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-xxxxxxxx"

{
  "id": "task_xxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxx",
  "status": "completed",
  "progress": 100,
  "image_url": "https://cdn.example.com/generated/image.png",
  "url": "https://cdn.example.com/generated/image.png",
  "metadata": {
    "result_urls": ["https://cdn.example.com/generated/image.png"]
  },
  "success": true,
  "final": true
}

同步图片生成

POSThttps://api1.link-ai.cc/v1/images/generations

curl -X POST "https://api1.link-ai.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "premium product photography, soft studio light",
    "size": "2048x2048",
    "n": 1,
    "response_format": "b64_json"
  }'

同步结果遵循 OpenAI 图片接口结构。根据模型和渠道，data 中会返回 b64_json 或 url。

{
  "created": 1785230000,
  "data": [
    {"b64_json": "iVBORw0KGgoAAA..."}
  ]
}

常用模型

下列为当前常用模型。实际可调用模型以控制台或 GET /v1/models 为准。

异步任务模型

gpt-image-2-1Kgpt-image-2-2Kgpt-image-2-4knana-banana-2nana-banana-2-4knana-banana-pronana-banana-pro-4k

同步模型

gpt-image-2nana-banana-2_syncnana-banana-2-4k_syncnana-banana-pro_syncnana-banana-pro-4k_sync

请求参数

同步接口

字段	类型	必填	说明
`model`	string	是	图片模型 ID。
`prompt`	string	是	图片内容描述。
`size`	string	否	如 `1024x1024`、`2048x2048`；具体预设取决于模型。
`n`	integer	否	生成数量，默认 1；平台上限为 10，部分模型仅支持 1。
`quality`	string	否	部分模型支持，如 `standard`、`hd`。
`response_format`	string	否	`b64_json` 或 `url`，以模型支持为准。
`images` / `image`	array / string	否	参考图 URL，用于图生图或编辑。

异步接口补充字段

字段	类型	说明
`seconds`	string	图片任务兼容字段，可省略；传入时使用字符串 `"4"`。
`aspect_ratio` / `ratio`	string	常用值：`16:9`、`9:16`、`3:4`、`4:3`、`1:1`。
`images`	string[]	公网 HTTPS 参考图 URL 数组。

结果读取与错误处理

异步完成后优先读取 image_url，没有时读取 url 或 metadata.result_urls[0]。同步接口读取 data[0].b64_json 或 data[0].url。

返回的结果 URL 可能会过期。请在任务完成后及时下载并保存到自己的存储服务。

{
  "error": {
    "message": "模型不可用或参数不受支持",
    "type": "invalid_request_error",
    "code": "upstream_error"
  }
}