首页/接入文档
API Reference

接入文档

OpenAI 格式兼容，改 base_url 与 api_key 两个变量即可迁移。

»四步跑通

从零到第一次成功调用，大约 3 分钟

无需信用卡
1
注册并创建 API Key
到注册页注册（送 ¥5 演示额度）， 进入控制台点「创建新 Key」。 创建时可一并指定这条 Key 的 渠道范围（只走你信任的几家）与 选路策略 （自动择优 / 低价优先 / 最快优先），之后随时可改。
2
记下 Base URL
本地测试用下面这个地址；正式部署后换成你的域名。
base_url 
…
3
用任意 OpenAI SDK 发一次请求
把 model 换成平台上架的任何模型名即可，例如 deepseek-chat。下面有现成的三语言示例。
4
在响应里核对实际走的渠道与费用
非流式响应会多带一个 x_aibangs 字段，写明本次命中哪家渠道、 走了什么选路、扣了多少钱、耗时多少——对账不用猜。

≡端点

与 OpenAI 接口路径完全一致

方法路径计费单位说明
GET/v1/models—列出平台可调用的模型；暂不可交付的模型另列在 unavailable 里并给出原因
POST/v1/chat/completions按 token对话补全（支持 stream 流式）
POST/v1/images/generations按张文生图 / 图生图，返回结构与 OpenAI 一致
POST/v1/audio/transcriptions按分钟语音转写，multipart/form-data 直通，需带 model 与 file 字段
对话、图像生成、语音转写三条链路已经可用。视频生成与音乐生成暂不可调用—— 这两类各家接口不统一，平台适配层还在建设中，因此在市场页只作「接入中」展示，不参与榜单排名， 调用会返回 category_not_callable。

⌘调用示例

把 你的KEY 与 模型名 换成你自己的

request.sh 

        

      

    

  


  
  

    

      

        
▶在线试用

          
不写代码，先在浏览器里打通一次

      

      

        

          

            

              
              
            

            

              
              
            

          

          

            
            
          

          

            
            真实消耗余额，按实际用量扣费
          

        

        
      

    

  


  
  

    

      

        
¥计费与选路

          
钱怎么算、请求走哪条渠道

        
查看实时报价 →

      

      

        

          
计价单位由模型类目决定，不是一律按 token——这一点很多中转站含糊其辞，我们写清楚：
            文本按 token（(输入token × 输入单价 + 输出token × 输出单价) ÷ 1,000,000）、
            图像按张（张数 × 单价）、
            语音转写按分钟（分钟数 × 单价）。
            价格按你实际命中的那条渠道计算——同一模型不同渠道价格不同；每次响应都会回传计费用量。

        

        

          

            
选路规则 ①

            
你在市场上「固定」过的渠道 → 优先走它

          

          

            
选路规则 ②

            
没固定 → 平台按稳定性评分自动择优

          

          

            
响应里的平台字段
x_aibangs

            

              provider 走的哪家 ·
              route 指定/自动 ·
              cost 本次费用 ·
              unit 计价单位 ·
              units 消耗单位数（张/分钟） ·
              total_ms 本次总耗时 ·
              ttft_ms 首字延迟 （仅文本类返回） ·
              estimated 是否估算值
              
图片与音频类目没有「第一个字」，
                所以不会返回 ttft_ms——给它们编一个首字延迟是假指标。
                这两类只看 total_ms（出图 / 转写总耗时）。

            

          

        

      

    

  


  
  

    

      

        
!错误码
按状态码对症处理

      

      

        

          

            
状态码含义怎么处理

            
              
401Key 无效或已吊销到控制台确认 Key，或重新创建

              
402余额不足充值后再调用

              
404模型不存在，或不在该 Key 的渠道范围内先 GET /v1/models 看可用模型；范围问题到控制台「渠道设置」调整

              
404category_not_callable：该类目暂不可交付视频 / 音乐类目适配层建设中，请改用在售的可调用模型

              
502上游不可达 / 返回异常多为渠道问题，探针会记下来，平台侧切流

              
503渠道未配置上游地址或密钥该渠道尚未开通，属平台侧待配置项