Skip to main content
POST
https://xcompute.us
/
v1
/
images
/
generations
curl --request POST \
  --url https://xcompute.us/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "imagen-4.0-apimart",
    "prompt": "一只戴着宇航员头盔的柯基犬，站在月球表面，背景是地球，电影感光效，8k",
    "size": "16:9"
  }'

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

Documentation Index

Fetch the complete documentation index at: https://api.xcompute.us/llms.txt

Use this file to discover all available pages before exploring further.

  • 异步处理模式，返回任务ID用于后续查询
  • 基于 Google Imagen 4 模型，高质量图像生成
  • 仅支持文生图，不支持图生图 / 参考图
  • 支持比例：1:1（正方形）、4:3（横屏）、3:4（竖屏）、16:9（横屏）、9:16（竖屏），默认 16:9
  • 生成的图像链接，有效期为24小时，请尽快保存
curl --request POST \
  --url https://xcompute.us/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "imagen-4.0-apimart",
    "prompt": "一只戴着宇航员头盔的柯基犬，站在月球表面，背景是地球，电影感光效，8k",
    "size": "16:9"
  }'

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

​
Authorizations

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

​
Body

​
model
string
default:"imagen-4.0-apimart"
required
图像生成模型名称固定填写 imagen-4.0-apimart
​
prompt
string
required
图像生成的文本描述英文 / 中文描述均可
​
n
integer
default:"1"
生成图片张数取值范围：1
​
size
string
default:"16:9"
图像生成的比例支持的格式：
  • 1:1 - 正方形
  • 4:3 - 横屏
  • 3:4 - 竖屏
  • 16:9 - 横屏（默认）
  • 9:16 - 竖屏
传入不在支持列表里的比例（如 21:9）会被自动回退到默认 16:9，不会报错。
不支持的字段：image、image_urls、mask、quality 等会被忽略。如果传入 image_urls / image 字段会直接报错：google_imagen4 currently supports text-to-image only。

​
Response

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