快速开始

第一步：准备令牌

1. 登录 OpenFDE 控制台。
2. 在密钥管理中创建 API Key。
3. 确认令牌允许外部访问，并配置了目标模型的白名单、分组和额度。

第二步：确认模型

不要直接复制旧教程中的模型名。先查询当前令牌：

curl https://api.openfde.work/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

从响应的 data[].id 中选择精确模型 ID。模型列表会随着渠道和权限变化。

第三步：发起调用

cURL

curl https://api.openfde.work/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_completion_tokens": 256
  }'

将 gpt-6-sol 替换成你在 /v1/models 返回中实际看到的模型。示例用于展示调用格式，不保证每个令牌都能看到。

Python

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.openfde.work/v1",
)

response = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "Hello!"}],
    max_completion_tokens=256,
)

print(response.choices[0].message.content)

常用入口

• Chat：POST /v1/chat/completions
• Responses：POST /v1/responses，仅对实现了 Responses 适配的模型开放。
• Images：POST /v1/images/generations、POST /v1/images/edits
• Embeddings：POST /v1/embeddings，先确认模型列表中存在 embedding 模型。
• Audio：POST /v1/audio/transcriptions、/v1/audio/speech
• Models：GET /v1/models

参数迁移

• 新项目使用 max_completion_tokens；max_tokens 仅作为兼容字段保留。
• 新项目使用 tools / tool_choice；旧 functions / function_call 不再作为推荐写法。
• temperature、top_p、stop、response_format 等参数由模型决定是否支持，遇到参数错误时按模型能力删除。
• 流式请求设置 stream: true，逐行读取 SSE 并等待 data: [DONE]。

常见问题

为什么模型列表和同事的不一样？

列表按令牌白名单、分组、企业等级、IP 限制和渠道状态过滤。两把 Key 返回不同结果是正常的。

为什么返回 model_not_found？

先重新调用 /v1/models，确认模型 ID、权限和版本后缀；不要使用已经下架的旧模型名。

为什么推理模型正文为空？

检查 finish_reason。如果是 length，提高 max_completion_tokens，因为推理内容可能已经消耗了输出预算。