快速结论
- 支持 prompt 驱动文生图，适合营销、电商和创意素材场景。
- 支持参考图工作流，可提升风格一致性与可控性。
- 建议先在模型页收敛参数，再迁移到生产 API。
关键参数
- model | string | 必填 | grok-image | - | 模型标识，使用 ToAPIs 真值。
- prompt | string | 必填 | - | - | 图像描述文本。
- size | string | 可选 | 1:1 | - | 输出宽高比，按模型能力可选。
- n | integer | 可选 | 1 | - | 单次请求生成数量。
- reference_images | file[] | 可选 | - | - | 参考图数组，用于风格一致性控制。
常见错误
- 400 invalid_request_error: 触发=请求体字段缺失或类型不合法。; 修复=校验 model/prompt/size 等参数格式。; 重试=修复参数后重试。
- 401 authentication_error: 触发=API Key 缺失或无效。; 修复=检查 Authorization 头与密钥权限。; 重试=修复鉴权后重试。