创建补全（Completions 格式）

POST https://open.feiyutoken.com/v1/completions

请求参数

参数	类型	必填	说明
model	string	是	模型名。沿用厂商官方命名，注意大小写；可用值见模型列表
prompt	string | array	是	提示词。可以是单条字符串，也可以是字符串数组，一次提交多个提示词
max_tokens	integer	否	本次生成的长度上限。设小了结果会被截断，此时 finish_reason 为 length
temperature	number	否	采样温度
top_p	number	否	核采样
n	integer	否	每个提示词生成几个候选，choices 会返回对应条数
stream	boolean	否	true 时走 SSE 流式；默认 false
stop	string | array	否	遇到这些字符串就停止生成
suffix	string	否	补全结果之后要接上的后缀文本
echo	boolean	否	true 时把 prompt 一并回显在 choices[].text 里

其余 OpenAI 标准参数按原样透传。

请求示例

curl https://open.feiyutoken.com/v1/completions \
  -H "Authorization: Bearer <你的飞鱼Token API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "prompt": "用一句话解释什么是 API 网关：",
    "max_tokens": 128
  }'

响应

{
  "id": "cmpl-...",
  "object": "text_completion",
  "created": 1770000000,
  "model": "<模型名>",
  "choices": [
    {
      "text": "API 网关是...",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 36,
    "total_tokens": 60
  }
}

结果在 choices[].text，不在 message.content —— 这一点和对话接口不同。 finish_reason 为 stop 表示正常结束，length 表示达到 max_tokens 被截断。

和对话接口的区别

两者都能生成文本，但输入结构不一样：

对比项	/v1/completions	/v1/chat/completions
输入	单条 prompt	messages 数组（system / user / assistant）
输出	choices[].text	choices[].message.content
多轮对话	需要自己拼接历史	直接传 messages
工具调用	无对应参数	支持 tools / tool_choice

单轮续写、模板化批量生成用本接口；需要多轮上下文、工具调用或结构化输出时，用 Chat Completions API。