Tasks
创建任务
创建一个生成任务。成功响应只代表任务已被接受，不代表生成已经完成。
Endpoint
POST /api/v1/jobs/createTaskHeaders
Authorization: Bearer sk-your-api-key
Content-Type: application/json
X-Request-ID: xxxxxxxxxxxxHeader 参数说明
| Header | 必填 | 如何配置 | 说明 |
|---|---|---|---|
Authorization | 是 | Bearer sk-your-api-key | 你的 API key。可以在 API Keys 页面 创建。 |
Content-Type | 是 | application/json | 请求体必须是 JSON，所以这个 header 必须传。 |
X-Request-ID | 否，但强烈建议传 | 使用 UUID 或你自己的服务端请求 ID | createTask 的幂等请求头。如果同一个 API key 再次发送相同的 request ID，API 可以直接返回已有任务，避免重复创建。 |
关于 X-Request-ID
X-Request-ID 不是必填。不传这个 header，请求也可以正常成功，API 也会正常创建任务。
但在生产环境里，强烈建议你传这个值，尤其是你的服务端存在这些情况时：
- 网络超时后自动重试
- 客户端重试请求
- 队列 worker 重试任务
- 用户重复点击同一个动作
推荐生成方式：
- 例如
xxxxxxxxxxxx - 使用你自己的业务请求 ID，例如
order-20260429-000123 - 使用你内部的任务 ID，例如
image-task-user123-456
最佳实践：
- 由你自己的服务端生成
X-Request-ID - 同一个逻辑请求重试时，保持这个值不变
- 新的逻辑请求，生成新的值
Body
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 公开模型 ID |
input | object | 是 | 模型输入参数 |
示例
curl -X POST "https://aigptimage.com/api/v1/jobs/createTask" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-H "X-Request-ID: xxxxxxxxxxxx" \
-d '{
"model": "gpt-image-2-text-to-image",
"input": {
"prompt": "A clean product photo of a translucent glass speaker",
"aspect_ratio": "1:1",
"resolution": "1K"
}
}'响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_xxx"
}
}积分行为
API 使用和网页端相同的计费逻辑扣积分。扣积分逻辑已经处理并发，避免并发请求导致余额被超用。