通过 OpenAI 聊天格式调用支持图片输出的 Gemini 模型。
请求
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 路径 | /v1/chat/completions |
| 网关地址 | https://ailink.nativex.com |
| 认证 | Authorization: Bearer sk-xxxx,替换为你的 API Key |
| 请求格式 | application/json |
示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。
参数说明
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
model |
Body | string | 是 | 支持图片输出及聊天兼容调用的 Gemini 模型 |
messages |
Body | object[] | 是 | 以 user 消息描述要生成或编辑的图片 |
stream |
Body | boolean | 否 | 是否使用 SSE;示例使用 false |
这是聊天兼容接口,图片结果不采用 Images API 的 data[] 结构。需要 imageConfig 等原生配置时,优先使用 Gemini 原生接口。
调用示例
curl -X POST 'https://ailink.nativex.com/v1/chat/completions' \
-H 'Authorization: Bearer sk-xxxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "画一只坐在窗边的橘猫,水彩风格。"
}
],
"stream": false
}'
响应
以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。
{
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": ""
},
"finish_reason": "stop"
}
]
}
| 字段或结果 | 说明 |
|---|---|
| choices[].message.content | 兼容格式可能以 Markdown 图片或数据链接返回图片;以实际结果为准 |
错误处理
非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。