图片生成 API

创建图片任务

POST /api/v1/images 创建图片生成任务，被接受时消耗积分。

POST https://vidrush-ai.com/api/v1/images
Authorization: Bearer sk-your-api-key
Content-Type: application/json

请求体

字段	必填	类型	说明
`model`	是	string	来自 `GET /api/v1/models?type=image` 的当前模型 ID
`prompt`	是	string	非空图片指令
`scene`	否	string	`text-to-image` 或 `image-to-image`；须为模型支持
`image_urls`	否	string[]	公网 HTTP(S) 图片 URL；`image-to-image` 必填
`options`	否	object	模型专属生成控制项

省略 scene 时默认为 text-to-image；若 image_urls 非空则推断为 image-to-image。

`options`

字段	类型	说明
`aspect_ratio`	string	支持的比例，如 `1:1`、`16:9`、`9:16`
`quality`	string	支持的质量，如 `1K`、`2K`、`4K`

只发送所选模型和场景公开的值。GET /api/v1/models?type=image 是实时的机器可读来源。

示例

curl -X POST https://vidrush-ai.com/api/v1/images \
  -H "Authorization: Bearer $VIDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "scene": "text-to-image",
    "prompt": "A paper kite crossing a bright summer sky",
    "options": { "aspect_ratio": "16:9", "quality": "2K" }
  }'

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_123",
    "status": "processing",
    "costCredits": 8
  }
}

用 data.id 调用 GET /api/v1/tasks/{taskId}，每 5 秒轮询一次直到终态。成功时从 data.taskUrls 读取生成的图片 URL。

图片生成 API

创建图片任务

请求体

options

示例

成功响应

On this page

`options`