Generate 3.0（文生图）

OpenAPI Specification

接口：POST /ideogram/v1/ideogram-v3/generate（完整地址 https://api.allyang.cn/ideogram/v1/ideogram-v3/generate）

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（该字段非必填）。

请求头

• accept：必填，固定 application/json。

请求体（multipart/form-data）

必传字段为 prompt。

• prompt：string，必传；画面提示词。
• rendering_speed：string，可选；原文档未给出该字段的取值说明。
• character_reference_images：binary，可选；用于保持角色一致性的参考图，支持多张。

响应

• 500：原文档仅记录了这一状态码，返回 code（string）、message（string）、data（原文类型标注为 null），三项均为必返。
• 其它状态码与响应字段：原文档未描述，待补。

响应示例字段：created（string，创建时间）、resolution（string，图片分辨率）、is_image_safe（boolean，内容安全标记）、seed（integer，随机种子）、url（string，图片地址，示例已脱敏）、style_type（string，风格类型，示例 GENERAL）。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 补充：本接口调用 Ideogram 3.0 模型，按提示词与可选参数同步出图；返回的图片链接有效期为 24 小时，超时后无法再访问；图片地址由平台代理。