在请求中传递自定义 Header,用于链路追踪、用户归因和日志记录。
图像生成
import { RouterBrain } from '@router-brain/sdk';
const rb = new RouterBrain('sk-your-api-key');
const result = await rb.image({
model: 'dall-e-3',
prompt: '一幅美丽的风景画',
headers: {
'x-trace-id': 'trace-001', // 关联日志与请求
'x-user-id': 'user-123', // 标识终端用户
'x-agent-name': 'my-agent', // 标识调用方
},
}).json();
这些字段会透传到上游并记入用量日志,方便事后排障与归因。
| Header | 用途 |
|---|---|
x-trace-id | 链路追踪,关联跨系统日志 |
x-user-id | 标识终端用户,用于用量归因 |
x-agent-name | 标识调用方应用 |
OpenAI / Anthropic 接口
对话和消息调用可通过 openai 和 @anthropic-ai/sdk 原生的 Header 机制传递。