图像生成
概览
- 请求方法:
POST - 路径:
/v1/images/generations - 内容类型:
application/json
认证方式
Authorization: Bearer sk-xxx(必选)
请求示例
Header
| Header | 示例 | 必填 |
|---|---|---|
| Content-Type | application/json | 是 |
| Authorization | Bearer sk-xxxx | 是 |
请求体(JSON)
json
{
"model": "grok-2-image-1212",
"prompt": "一幅详细的图像描绘了一个广阔的石器时代城市,城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡,各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装,与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线,而人们则保留着原始的设计,身上披着毛皮,搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。",
"n": 1,
"response_format": "url"
}参数说明
| 参数 | 类型 | 必填 | 默认 | 描述 |
|---|---|---|---|---|
| prompt | string | 是 | - | 所需图像的文本描述,最大1000(4000)字符 |
| model | string | 是 | - | 模型名称,如 grok-2-image-1212 |
| n | number | 否 | 1 | 生成数量,dall-e-2支持1-10,dall-e-3仅支持1 |
| response_format | string | 否 | url | 返回格式,url或b64_json |
返回示例(200)
json
{
"data": [
{
"url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-11b443c1-3780-4690-849a-51430eecc0a9.jpeg",
"revised_prompt": "A high-resolution photograph of a bustling prehistoric city during the day, featuring towering skyscrapers made of large stones and bones..."
}
]
}