Skip to main content

​
接口说明

模型列表可在模型广场上查看

​
POST /v1/chat/completions

通用接口，支持对话聊天、图像生成、图像编辑、视频生成、视频超分 
curl https://niuapi.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $智牛API Token" \
  -d '{
    "model": "grok-4",
    "messages": [{"role":"user","content":"你好"}]
  }'
支持的请求参数 生成图片的model名称应该为grok-imagine-1.0 生成视频的model名称应该为grok-imagine-1.0-video
字段类型说明可用参数
modelstring模型名称见上方模型列表
messagesarray消息列表见下方消息格式
streamboolean是否开启流式输出true, false
reasoning_effortstring推理强度none, minimal, low, medium, high, xhigh
temperaturenumber采样温度0 ~ 2
top_pnumbernucleus 采样0 ~ 1
toolsarray工具定义OpenAI function tools
tool_choicestring/object工具选择auto, required, none 或指定工具
parallel_tool_callsboolean是否允许并行工具调用true, false
video_configobject视频模型专用配置对象支持：grok-imagine-1.0-video
└─aspect_ratiostring视频宽高比16:9, 9:16, 1:1, 2:3, 3:2, 1280x720, 720x1280, 1792x1024, 1024x1792, 1024x1024
└─video_lengthinteger视频时长 (秒)6 ~ 30
└─resolution_namestring分辨率480p, 720p
└─presetstring风格预设fun, normal, spicy, custom
image_configobject图片模型专用配置对象支持：grok-imagine-1.0 / grok-imagine-1.0-fast / grok-imagine-1.0-edit
└─ninteger生成数量1 ~ 10
└─sizestring图片尺寸1280x720, 720x1280, 1792x1024, 1024x1792, 1024x1024
└─response_formatstring响应格式url, b64_json, base64
消息格式 (messages)：
字段类型说明
rolestring角色：developer, system, user, assistant
contentstring/array消息内容，支持纯文本或多模态数组
多模态内容块类型 (content array)：
type说明示例
text文本内容{"type": "text", "text": "描述这张图片"}
image_url图片 URL{"type": "image_url", "image_url": {"url": "https://..."}}
input_audio音频{"type": "input_audio", "input_audio": {"data": "https://..."}}
file文件{"type": "file", "file": {"file_data": "https://..."}}
注意事项：
  • image_url/input_audio/file 仅支持 URL 或 Data URI（data:<mime>;base64,...），裸 base64 会报错。
  • reasoning_effort：none 表示不输出思考，其他值都会输出思考内容。
  • 工具调用为提示词模拟 + 客户端执行回填：模型通过 <tool_call>{...}</tool_call> 输出调用请求，服务端解析为 tool_calls；不执行工具。
  • grok-imagine-1.0-fast 与瀑布流 imagine 生成链路一致，可直接通过 /v1/chat/completions 调用；其 n/size/response_format 由服务端 [imagine_fast] 统一控制。
  • grok-imagine-1.0-fast 在 /v1/chat/completions 的流式输出仅返回最终成图，不返回中间预览图。
  • grok-imagine-1.0-fast 流式 URL 出图会保持原始图片名（不追加 -final 后缀）。
  • 当图片疑似被审查拦截导致无最终图时，若开启 image.blocked_parallel_enabled，服务端会按 image.blocked_parallel_attempts 自动并行补偿生成，并优先使用不同 token；若仍无满足 image.final_min_bytes 的最终图则返回失败。
  • grok-imagine-1.0-edit 必须提供图片，多图默认取最后 3 张与最后一个文本。
  • grok-imagine-1.0-video 支持文生视频与图生视频（通过 image_url 传参考图，仅取第 1 张）。
  • 除上述外的其他参数将自动丢弃并忽略。