API 参考

完整能力示例（TypeScript）

只列出已开放且批准对应能力的模型。工具示例可能发起两次收费请求，需为两次请求分别预留余额。每一步异常时先按该步编号查询状态，不自动重发。

将 YOUR_MODEL_ID 替换为支持所选能力的可用模型 ID；请核对模型支持的参数。

// npm install openai
// 在服务端设置 ASIORB_API_KEY 和持久保存的 ASIORB_REQUEST_ID；每个逻辑调用单独计费。
import OpenAI from 'openai';
const key=process.env.ASIORB_API_KEY, id=process.env.ASIORB_REQUEST_ID;
if(!key||!id)throw new Error('缺少环境变量');
const client=new OpenAI({apiKey:key,baseURL:"https://api.asiorb.com:8443/v1",timeout:210000,maxRetries:0});
const model="YOUR_MODEL_ID";
const messages=JSON.parse('[{"role":"user","content":"请使用 add 工具计算 2 + 3。"}]');
const tools=JSON.parse('[{"type":"function","function":{"name":"add","description":"计算两个有限数字的和","parameters":{"type":"object","properties":{"a":{"type":"number"},"b":{"type":"number"}},"required":["a","b"],"additionalProperties":false}}}]');
const first=await client.chat.completions.create({model,messages,tools,max_tokens:1024},{headers:{'Idempotency-Key':id}});
console.log('第一次用量',first.usage);
const reply=JSON.parse(JSON.stringify(first.choices[0].message));
if(reply.tool_calls?.length){
  // 只保留网关支持的消息字段；模型需要的推理历史一并保留。
  messages.push({role:'assistant',content:reply.content,tool_calls:reply.tool_calls,...(reply.reasoning?{reasoning:reply.reasoning}:{}),...(reply.reasoning_details?{reasoning_details:reply.reasoning_details}:{})});
  for(const call of reply.tool_calls){
    if(call.type!=='function'||call.function.name!=='add')throw new Error('工具不在允许范围');
    const args=JSON.parse(call.function.arguments);
    if(!args||typeof args!=='object'||Object.keys(args).sort().join(',')!=='a,b'||![args.a,args.b].every(n=>typeof n==='number'&&Number.isFinite(n)&&Math.abs(n)<=1e6))throw new Error('工具参数无效');
    // 工具在客户端执行；这里没有 eval、shell 或任意联网。
    messages.push({role:'tool',tool_call_id:call.id,content:JSON.stringify({result:args.a+args.b})});
  }
  // 这是新一次模型调用，需单独持久化此编号、余额和预占。
  const nextId=id+'-tool-result';
  const second=await client.chat.completions.create({model,messages,tools,max_tokens:1024},{headers:{'Idempotency-Key':nextId}});
  console.log(second.choices[0].message.content);
  console.log('第二次用量',second.usage);
}else console.log(reply.content);
// 任何一步异常时，用该步的幂等键 GET /requests 查询，不自动重新 POST。