Grok Imagine Image

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A serene mountain landscape at sunset with vibrant colors",
    "size": "16:9"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A serene mountain landscape at sunset with vibrant colors",
    "size": "16:9"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

使用 Grok Imagine 模型生成高质量图像。支持文生图和图生图，可选指定宽高比。图生图时，input.image_urls 必填，且必须是只包含一个 URL 字符串的数组，指向参考图。请提供已上传文件的 URL；支持的类型：image/jpeg、image/png、image/webp；最大大小：10.0MB。两种模式下 input.size 均为可选。支持的值：2:3、3:2、1:1、16:9、9:16。

模型

grok-imagine-image - 文生图和图生图

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key：登录 PoYo，进入仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

必填

Grok Imagine Image 模型标识符

可用选项:

grok-imagine-image

callback_url

string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

input

object

生成的输入参数。图生图时 input.image_urls 必填。

Show child attributes

响应

任务提交成功

code

enum<integer>

必填

业务状态码。200 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的 code 为 400。

200：成功
400：请求参数无效
401：API Key 缺失或无效
402：积分不足
403：没有权限
404：资源不存在
408：请求超时
429：请求频率超限
500：服务器内部错误
502：上游服务错误
503：服务暂不可用

详见错误码。

可用选项:

200,

400,

401,

402,

403,

404,

408,

429,

500,

502,

503

示例:

200

data

object

必填

Show child attributes

​模型

授权

请求体

响应

模型