OmniRoute Image 用于通过 OmniRoute 统一入口完成图像生成相关操作,接口采用与 OpenAI 兼容的 /v1/images 系列格式,后端可在多个图像提供方之间自动回退。
使用前提:需要设置环境变量 OMNIROUTE_URL 与 OMNIROUTE_KEY,具体配置步骤参见入口 SKILL 的说明。
主要端点:
- POST $OMNIROUTE_URL/v1/images/generations:文生图。
- POST $OMNIROUTE_URL/v1/images/edits:基于遮罩的图像编辑。
- POST $OMNIROUTE_URL/v1/images/variations:生成图像变体。
模型发现:可通过 curl $OMNIROUTE_URL/v1/models/image | jq '.data[]' 查询可用图像模型,返回每个模型的 id、owned_by、sizes 与 capabilities 等信息。
生成调用示例:
curl -X POST $OMNIROUTE_URL/v1/images/generations
-H "Authorization: Bearer $OMNIROUTE_KEY"
-H "Content-Type: application/json"
-d '{
"model": "dall-e-3",
"prompt": "a red bicycle on a wet street, photoreal",
"n": 1,
"size": "1024x1024",
"response_format": "b64_json"
}'
响应格式为 { created, data: [{ url? 或 b64_json, revised_prompt }] }。
错误说明:400 invalid_size 表示该模型不支持所请求的尺寸,可检查 /v1/models/image 确认;400 content_policy_violation 表示被提供方安全策略拦截;503 表示提供方不可用,可尝试 /v1/models/image 中列出的其他模型。
适用场景:需要在多个图像生成提供方之间统一调用、切换或回退时使用。限制方面,具体计费、速率限制及完整配置细节暂未提供。