模型 API 为文本生成、多模态、语音、图像、向量和重排任务提供统一入口。请求需携带项目 API 密钥；模型 ID 和支持的接口请以模型目录为准。

通用配置

• 基地址：https://api.feiqiao.ai/v1
• 认证：Authorization: Bearer $FEIQIAO_API_KEY
• 内容类型：JSON 请求使用 Content-Type: application/json；音频上传按示例使用 multipart 表单。

接口详情：

• Responses API（编程智能体）
• Chat Completions 与 OCR
• 向量嵌入 与 文档重排
• 音频转文字 与 文字转语音
• 图像生成

对话补全

POST /v1/chat/completions

使用 model 和 messages 发送对话请求。可用于支持该接口的文本与多模态模型；图像输入格式取决于具体模型。

curl https://api.feiqiao.ai/v1/chat/completions \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"你好"}]}'

Responses

POST /v1/responses

为兼容 Responses API 的模型创建回复，可提供文本或图像输入，并根据模型能力使用工具调用或对话状态。

curl https://api.feiqiao.ai/v1/responses \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","input":"请简要介绍模型 API。"}'

图像文字识别（OCR）

POST /v1/chat/completions

将图像地址放入用户消息的 image_url 内容块，并选择 OCR 模型。请求正文使用 Chat Completions 的消息结构。

{
  "model": "DeepSeek-OCR",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "请识别图中文字" },
      { "type": "image_url", "image_url": { "url": "https://example.com/page.png" } }
    ]
  }]
}

向量嵌入

POST /v1/embeddings

提交文本和嵌入模型 ID，获取可用于语义搜索、聚类或检索的向量表示。输入字段及批量限制请以控制台当前规格为准。

{
  "model": "BAAI/bge-m3",
  "input": ["第一段文本", "第二段文本"],
  "encoding_format": "float"
}

input 和 model 为必填字段；encoding_format 可设为 float 或 base64，也可按需指定 dimensions。

音频转文字

POST /v1/audio/transcriptions

以 multipart 表单上传音频文件，并指定转写模型。当前示例使用 qwen3-asr，并请求词级和片段级时间戳。支持 FLAC、MP3、MP4、MPEG、M4A、OGG、WAV 和 WebM。

curl https://api.feiqiao.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -F "model=qwen3-asr" \
  -F "timestamp_granularities=word,segment" \
  -F "file=@test.wav" | jq

curl -F 会自动设置带 boundary 的 multipart 请求头。

典型响应：

{
  "text": "Testing one two three. This is a short audio transcription test.",
  "usage": {
    "input_token_details": null,
    "input_tokens": null,
    "output_tokens": null,
    "seconds": 5.0,
    "total_tokens": null,
    "type": "duration"
  }
}

文字转语音

POST /v1/audio/speech

提供模型 ID、文本和声音参数，可按需选择 MP3、Opus、AAC、FLAC、WAV 或 PCM 输出格式。

请求需要包含 model、input 和 voice。接口文档列出的声音预设为 alloy，播放速度范围为 0.25 到 4。

图像生成

POST /v1/images/generations

提供图像模型 ID 和文本提示词，可选设置生成数量、尺寸、质量和输出格式。

{
  "model": "gpt-image-2.5-flare",
  "prompt": "一座被晨光照亮的海边城市",
  "size": "1024x1024",
  "n": 1
}

n 的范围为 1 到 10；可选尺寸包括 1024x1024、1536x1024、1024x1536 和 auto。

文档重排

POST /v1/rerank

提交查询文本和候选文档列表，由重排模型按照相关性排序。可使用 top_n 限制返回数量。

{
  "model": "BAAI/bge-reranker-v2-m3",
  "query": "如何配置 API 密钥？",
  "documents": ["配置步骤……", "定价说明……"],
  "top_n": 1
}

各接口的可用模型、参数和价格可能不同。集成前请查看对应模型页面与控制台配置。