跳转到主要内容
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": "gemini-3-pro-image-preview",
    "prompt": "月光下的竹林小径",
    "size": "1:1",
    "n": 1
  }'
{
  "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": "gemini-3-pro-image-preview",
    "prompt": "月光下的竹林小径",
    "size": "1:1",
    "n": 1
  }'
{
  "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:"gemini-3-pro-image-preview"
required
图像生成模型名称Example: "gemini-3-pro-image-preview"
prompt
string
required
图像生成的文本描述
size
string
图像生成的尺寸支持的格式:
  • 比例:1:12:33:23:44:34:55:49:1616:921:9
n
integer
生成图像的数量固定为 1⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错
image_urls
array
参考图像的 URL 列表,用于图生图或图像编辑💡 快速填写(Try it 区域):
  1. 点击 ”+ Add an item” 添加一个图像URL
  2. 输入图像的完整 URL 地址或base64数据
限制: 最多 5 张图片
mask_url
string
蒙版图像的 URL
  • 必须是 PNG 格式
  • 大小需要与参考图像一致
  • 不超过 4MB

Response

code
integer
响应状态码
data
array
返回数据数组