Skip to main content

接口说明

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

POST /v1/chat/completions

通用接口,支持对话聊天、图像生成、图像编辑、视频生成、视频超分
支持的请求参数 生成图片的model名称应该为grok-imagine-1.0 生成视频的model名称应该为grok-imagine-1.0-video 消息格式 (messages) 多模态内容块类型 (content array) 注意事项
  • image_url/input_audio/file 仅支持 URL 或 Data URI(data:<mime>;base64,...),裸 base64 会报错。
  • reasoning_effortnone 表示不输出思考,其他值都会输出思考内容。
  • 工具调用为提示词模拟 + 客户端执行回填:模型通过 <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 张)。
  • 除上述外的其他参数将自动丢弃并忽略。