API 参考
Chat Completions
发送消息列表、读取文本与用量,并维护多轮上下文。
发送文本请求
选择支持 Chat Completions 的模型,按 API 概览设置密钥,替换 <model-id> 后在 Bash 执行。
curl --fail-with-body 'https://gateway.irouter.io/v1/chat/completions' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","messages":[{"role":"user","content":"Reply with a short greeting."}],"stream":false}'核心字段
字段 | 说明 |
|---|---|
| 当前密钥可用的完整模型 ID,必填 |
| 有序消息数组,必填;每项包含角色及内容 |
| 是否使用 SSE;本文使用非流式 |
| 可选的工具定义,要求模型与线路支持 |
温度、输出长度和推理参数的支持因模型而异,先用上面的基础请求验证。不同模型的输出长度字段可能不同,不要同时堆叠不兼容参数。
读取并继续对话
文本通常位于 choices[0].message.content。还需检查 finish_reason:截断或工具请求不等同于完整文本回答。工具请求使用 tool_calls,内容可能为空。
多轮对话由应用保存并重新发送相关历史,包括助手消息和工具结果。历史会占用下一次请求的上下文与输入 Token。用量通常在 usage 中;流式用量另见流式输出。
协议字段参考 OpenAI Chat Completions,实际可用参数以所选 iRouter 模型与线路为准。