跳转到主要内容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Authorizations

​
Authorization
string
required
所有接口均需要使用Bearer Token进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gpt-4o-image"
required
图像生成模型名称Example: "gpt-4o-image"
​
prompt
string
required
图像生成的文本描述最长 1000 个字符
​
size
string
图像生成的尺寸支持的格式：
  • 比例：1:1、2:3、3:2
​
n
integer
生成图像的数量支持 1、2、4，会根据生成数量进行预扣费
​
image_urls
array
参考图像的 URL 列表，用于图生图或图像编辑
  • 最多 5 张图片
  • 每张图片不超过 10MB
  • 支持的格式：.jpeg、.jpg、.png、.webp
​
mask_url
string
蒙版图像的 URL
  • 必须是 PNG 格式
  • 大小需要与参考图像一致
  • 不超过 4MB

​
Response

​
created
integer
任务创建时间戳
​
id
string
任务唯一标识符
​
model
string
实际使用的模型名称
​
object
string
对象类型，固定为 image.generation.task
​
progress
integer
任务完成进度百分比（0-100）
​
status
string
任务状态可能的值：
  • pending - 等待处理
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
task_info
object
任务详细信息
​
type
string
输出类型，固定为 image
​
usage
object
计费信息