当个人开发者或企业团队将大模型能力集成到客服系统、AI 编程插件、沉浸式翻译、知识库问答（RAG）或自动化工作流中时，直接对接多家海外上游往往会遇到四大难题：
- 支付与风控门槛高：海外信用卡绑定繁琐，且容易因 IP 变动触发无预警封号，导致线上业务中断。
- 多厂商协议碎片化：同时用 GPT、Claude、Grok、智谱 GLM 时，需要维护多套 SDK、多份密钥和不同的错误重试逻辑。
- 预充值资金闲置：在五六个平台分别充值余额，资金分散且部分平台余额过期作废。
- 缺乏统一可观测性：很难在一处账单里看清今天哪个模型、哪个业务消耗了多少 Token。
Fish Ai API 开发者平台 正是为了解决上述工程痛点而生：提供一个统一 API Key、双协议原生兼容（OpenAI + Anthropic）、毫秒级流式转发与透明的按 Token 计费体系。
快速入口：访问 Fish Ai API 中心 即可查看实时模型价目表、在线创建 API Key，或返回 Fish Ai 主站首页 直接在网页测试模型效果。
1. 支持的核心协议与端点清单
Fish Ai 网关对主流接口路径做了完整支持（包含防呆的双 /v1/v1/ 路径兼容，避免部分第三方客户端自动重复拼接 /v1 报错）：
| 接口路径 | 协议规范 | 核心用途 | 代表模型 |
|---|---|---|---|
GET /v1/models | OpenAI 兼容 | 获取当前可用模型目录与元数据 | 全系在线模型 |
POST /v1/chat/completions | OpenAI 兼容 | 文本对话、多模态识图、工具调用、SSE 流式输出 | gpt-6-astra、gpt-6.1-sol、grok-4.7、glm-5.3 |
POST /v1/responses | OpenAI Responses | 新一代 OpenAI 响应接口兼容 | GPT-6 系列 |
POST /v1/messages | Anthropic 原生 | Claude 原生对话、Thinking 推理、Prompt Caching | claude-opus-5.5、claude-sonnet-5-5 |
POST /v1/images/generations | OpenAI 生图兼容 | 同步/异步 1K/2K/4K 文生图、GIF 动图 | gpt-image-2.6-flare、grok-imagine-image-2.0 |
POST /v1/videos | 视频异步任务 | 文生视频、图生视频、首尾帧视频创作 | grok-imagine-video-1.5 |
2. 三种主流语言/工具极速接入示例
示例一：cURL 命令行测试（5 秒验证连通性）
curl https://fishai.yanyumeta.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的FishAi密钥" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{"role": "user", "content": "你好！请用一句话介绍你自己。"}
],
"stream": false
}'示例二：Node.js / TypeScript (OpenAI SDK)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.FISHAI_API_KEY,
baseURL: 'https://fishai.yanyumeta.cn/v1'
});
async function main() {
// 只需改 model 字段，即可在 GPT-6、Claude、Grok 之间无缝切换
const completion = await client.chat.completions.create({
model: 'claude-sonnet-5-5',
messages: [
{ role: 'system', content: '你是一位高效的 API 助手。' },
{ role: 'user', content: '请给出一个标准的 RESTful 错误响应 JSON 示例。' }
]
});
console.log(completion.choices[0].message.content);
}
main();示例三：主流第三方客户端配置方法
在 Cursor、Cline、NextChat、LobeChat、沉浸式翻译、Dify、FastGPT 等客户端中，只需填写以下三项：
- 接口类型 / 服务商：选择
OpenAI 兼容 (OpenAI Compatible)或Anthropic - API 代理地址 (Base URL)：
https://fishai.yanyumeta.cn/v1 - API Key：粘贴在 API 中心 生成的
sk-...密钥 - 自定义模型名：填入
gpt-6-astra、gpt-6.1-sol、claude-opus-5.5或claude-sonnet-5-5
3. 生产环境最佳实践：安全、限流与账单核对
为了让你的线上应用稳如磐石，建议在接入时做好以下三点配置：
- 启用 IP 白名单：在 API 中心 创建或编辑密钥时，将你的生产服务器公网 IP 填入白名单。即使前端日志不慎泄露了 Key，非白名单 IP 也无法盗用你的积分。
- 开启流式传输（
stream: true）：对于长文本生成或高思考强度（Reasoning）请求，开启 SSE 流式响应不仅能让用户立即看到首字输出，还能配合网关的心跳保活机制避免长连接超时。 - 善用失败自动退回保障：无论是文本流式对话还是异步生图、视频生成，若上游因网络波动未能产出有效结果，系统预扣机制会自动退回未消费的积分，并在「API 日志」中清晰标注状态，确保每一分钱都花在真实输出上。