curl https://yunzhiapi.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的密钥" \
-d '{
"model": "你的模型名",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
],
"stream": false
}'

from openai import OpenAI

client = OpenAI(
    base_url="https://yunzhiapi.cn/v1",
    api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
    model="你的模型名",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://yunzhiapi.cn/v1",
  apiKey: "sk-你的密钥",
});
const resp = await client.chat.completions.create({
  model: "你的模型名",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

curl https://yunzhiapi.cn/v1/models \
-H "Authorization: Bearer sk-你的密钥"

curl https://yunzhiapi.cn/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"你的模型名","max_tokens":64,"messages":[{"role":"user","content":"Hi"}]}'

curl "https://yunzhiapi.cn/v1beta/models/你的模型名:generateContent" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Hi"}]}]}'

X-Request-ID: 3f6b2f34-8a1c-4d2e-9f7b-6c5a4b3d2e1f

{
"error": {
"message": "Model `gpt-4o-mini-x` not found.",
"type": "not_found_error",
"param": null,
"code": "YZ4001",
"request_id": "3f6b2f34-....",
"requested_model": "gpt-4o-mini-x",
"did_you_mean": ["gpt-4o-mini", "gpt-4o"],
"hint": "Check the model name spelling or GET /v1/models for the available list."
}
}

async function requestWithRetry(url, options, maxRetries = 5) {
for (let attempt = 0; attempt <= maxRetries; attempt++) {
const resp = await fetch(url, options);
if (resp.status !== 429) return resp;
const retryAfter = Number(resp.headers.get('Retry-After') || 0);
const backoff = Math.min(Math.pow(2, attempt + 1), 60);
const jitter = Math.random();
await new Promise(r => setTimeout(r, Math.max(retryAfter, backoff) * 1000 + jitter * 1000));
}
throw new Error('max retries exceeded');
}

{
"error": {
"message": "Insufficient balance.",
"type": "insufficient_quota_error",
"param": null,
"code": "YZ2001",
"request_id": "3f6b2f34-....",
"hint": "Recharge your account and retry."
}
}

{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "Insufficient balance. (code: YZ2001, request_id: 3f6b2f34-....)"
}
}

{
"error": {
"code": 402,
"message": "Insufficient balance. (code: YZ2001, request_id: 3f6b2f34-....)",
"status": "RESOURCE_EXHAUSTED"
}
}

curl "https://yunzhiapi.cn/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "你是一个乐于助人的助手。"},
{"role": "user", "content": "你好，请介绍一下你自己。"}
],
"temperature": 0.7,
"max_tokens": 1024,
"stream": false
}'

curl "https://yunzhiapi.cn/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "描述这张图片的内容"},
{"type": "image_url", "image_url": {"url": "https://example.com/photo.png", "detail": "auto"}}
]
}
]
}'

curl "https://yunzhiapi.cn/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "北京今天天气怎么样？"}],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "查询指定城市的实时天气",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
],
"tool_choice": "auto"
}'

"response_format": {
"type": "json_schema",
"json_schema": {
"name": "user_profile",
"strict": false,
"schema": {
"type": "object",
"properties": {
"name": {"type": "string"},
"age": {"type": "integer"}
},
"required": ["name", "age"]
}
}
}

{
"id": "chatcmpl-9f8e7d6c5b4a",
"object": "chat.completion",
"created": 1710000000,
"model": "gpt-4o",
"service_tier": "default",
"system_fingerprint": "fp_3a2b1c9d",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是一个 AI 助手，可以回答问题、协助写作和编程等。",
"refusal": null
},
"finish_reason": "stop",
"logprobs": null
}
],
"usage": {
"prompt_tokens": 24,
"completion_tokens": 18,
"total_tokens": 42,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
}
}

data: {"id":"chatcmpl-9f8e7d6c5b4a","object":"chat.completion.chunk","created":1710000000,"model":"gpt-4o","service_tier":"default","system_fingerprint":"fp_3a2b1c9d","choices":[{"index":0,"delta":{"role":"assistant","content":"你好","refusal":null},"finish_reason":null,"logprobs":null}]}
data: {"id":"chatcmpl-9f8e7d6c5b4a","object":"chat.completion.chunk","created":1710000000,"model":"gpt-4o","service_tier":"default","system_fingerprint":"fp_3a2b1c9d","choices":[{"index":0,"delta":{"content":"！","refusal":null},"finish_reason":null,"logprobs":null}]}
data: {"id":"chatcmpl-9f8e7d6c5b4a","object":"chat.completion.chunk","created":1710000000,"model":"gpt-4o","service_tier":"default","system_fingerprint":"fp_3a2b1c9d","choices":[{"index":0,"delta":{},"finish_reason":"stop","logprobs":null}]}
data: [DONE]

curl "https://yunzhiapi.cn/v1/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"prompt": "从前有座山，山里有座庙，",
"max_tokens": 256,
"temperature": 0.8
}'

{
"id": "chatcmpl-1a2b3c4d5e6f",
"object": "chat.completion",
"created": 1710000000,
"model": "gpt-4o",
"service_tier": "default",
"system_fingerprint": "fp_3a2b1c9d",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "庙里有个老和尚在讲故事，讲的是：从前有座山……",
"refusal": null
},
"finish_reason": "stop",
"logprobs": null
}
],
"usage": {
"prompt_tokens": 16,
"completion_tokens": 22,
"total_tokens": 38,
"prompt_tokens_details": {
"cached_tokens": 0,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 0,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
}
}

curl "https://yunzhiapi.cn/v1/responses" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"instructions": "你是一个乐于助人的助手。",
"input": "你好，请介绍一下你自己。",
"max_output_tokens": 1024,
"temperature": 0.7
}'

curl "https://yunzhiapi.cn/v1/responses" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"input": "北京今天天气怎么样？",
"tools": [
{
"type": "function",
"name": "get_weather",
"description": "查询指定城市的实时天气",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
]
}'

{
"id": "resp_9f8e7d6c5b4a3c2d1e0f",
"object": "response",
"created_at": 1710000000,
"status": "completed",
"model": "gpt-4o",
"output": [
{
"id": "msg_1a2b3c4d5e6f7a8b",
"type": "message",
"role": "assistant",
"status": "completed",
"content": [
{
"type": "output_text",
"text": "你好！我是一个 AI 助手，可以回答问题、协助写作和编程等。",
"annotations": []
}
]
}
],
"usage": {
"input_tokens": 24,
"output_tokens": 18,
"total_tokens": 42,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens_details": {
"reasoning_tokens": 0
}
},
"metadata": {},
"error": null,
"incomplete_details": null,
"instructions": null,
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": null,
"store": false,
"temperature": 1.0,
"tool_choice": "auto",
"tools": [],
"top_p": 1.0,
"truncation": "disabled",
"text": {
"format": {
"type": "text"
}
},
"max_output_tokens": null
}

event: response.created
data: {"type":"response.created","response":{"id":"resp_9f8e7d6c5b4a3c2d1e0f","object":"response","created_at":1710000000,"status":"in_progress","model":"gpt-4o","output":[],"usage":null,"metadata":{},"error":null,"incomplete_details":null,"instructions":null,"parallel_tool_calls":true,"previous_response_id":null,"reasoning":null,"store":false,"temperature":1.0,"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","text":{"format":{"type":"text"}},"max_output_tokens":null}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_1a2b3c4d5e6f7a8b","output_index":0,"content_index":0,"delta":"你好"}
event: response.output_text.done
data: {"type":"response.output_text.done","item_id":"msg_1a2b3c4d5e6f7a8b","output_index":0,"content_index":0,"text":"你好！"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_9f8e7d6c5b4a3c2d1e0f","object":"response","created_at":1710000000,"status":"completed","model":"gpt-4o","output":[{"id":"msg_1a2b3c4d5e6f7a8b","type":"message","role":"assistant","status":"completed","content":[{"type":"output_text","text":"你好！","annotations":[]}]}],"usage":{"input_tokens":24,"output_tokens":18,"total_tokens":42,"input_tokens_details":{"cached_tokens":0},"output_tokens_details":{"reasoning_tokens":0}},"metadata":{},"error":null,"incomplete_details":null,"instructions":null,"parallel_tool_calls":true,"previous_response_id":null,"reasoning":null,"store":false,"temperature":1.0,"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","text":{"format":{"type":"text"}},"max_output_tokens":null}}

curl "https://yunzhiapi.cn/v1/responses/resp_9f8e7d6c5b4a3c2d1e0f" \
-H "Authorization: Bearer $API_KEY"

{
"object": "list",
"data": [],
"first_id": null,
"last_id": null,
"has_more": false
}

curl "https://yunzhiapi.cn/v1/models" \
-H "Authorization: Bearer $API_KEY"

{
"object": "list",
"data": [
{
"id": "gpt-4o",
"object": "model",
"created": 1710000000,
"owned_by": "yunzhi-api",
"permission": [],
"root": "gpt-4o",
"parent": null,
"capabilities": []
},
{
"id": "claude-sonnet-4",
"object": "model",
"created": 1710000100,
"owned_by": "yunzhi-api",
"permission": [],
"root": "claude-sonnet-4",
"parent": null,
"capabilities": []
}
]
}

curl "https://yunzhiapi.cn/v1/models/gpt-4o" \
-H "Authorization: Bearer $API_KEY"

{
"id": "gpt-4o",
"object": "model",
"created": 1710000000,
"owned_by": "yunzhi-api"
}

curl "https://yunzhiapi.cn/v1/embeddings" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": "今天天气真好，适合出去散步。",
"encoding_format": "float"
}'

curl "https://yunzhiapi.cn/v1/embeddings" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": ["第一段文本", "第二段文本", "第三段文本"],
"dimensions": 512
}'

{
"object": "list",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [
0.0023064255,
-0.009327292,
0.015783105,
-0.021884446,
0.0068145283
]
}
],
"model": "text-embedding-3-small",
"usage": {
"prompt_tokens": 8,
"total_tokens": 8
}
}

curl "https://yunzhiapi.cn/v1/moderations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-moderation-latest",
"input": "这是一段待审核的用户评论文本。"
}'

{
"id": "modr-0abc123def456",
"model": "text-moderation-latest",
"results": [
{
"flagged": false,
"categories": {
"hate": false,
"hate/threatening": false,
"harassment": false,
"harassment/threatening": false,
"self-harm": false,
"self-harm/intent": false,
"self-harm/instructions": false,
"sexual": false,
"sexual/minors": false,
"violence": false,
"violence/graphic": false
},
"category_scores": {
"hate": 0.0001,
"hate/threatening": 0.00001,
"harassment": 0.0002,
"harassment/threatening": 0.00001,
"self-harm": 0.00001,
"self-harm/intent": 0.00001,
"self-harm/instructions": 0.00001,
"sexual": 0.0001,
"sexual/minors": 0.00001,
"violence": 0.0002,
"violence/graphic": 0.00001
}
}
]
}

{
"id": "modr-9f8e7d6c5b4a",
"model": "text-moderation-latest",
"results": [
{
"flagged": false,
"categories": {},
"category_scores": {}
}
]
}

curl "https://yunzhiapi.cn/v1/files" \
-H "Authorization: Bearer $API_KEY"

{
"object": "list",
"data": [
{
"id": "file-abc123",
"object": "file",
"bytes": 120000,
"created_at": 1710000000,
"filename": "train.jsonl",
"purpose": "fine-tune"
}
]
}

curl "https://yunzhiapi.cn/v1/files" \
-H "Authorization: Bearer $API_KEY" \
-F "file=@train.jsonl" \
-F "purpose=fine-tune"

{
"id": "file-abc123",
"object": "file",
"bytes": 120000,
"created_at": 1710000000,
"filename": "train.jsonl",
"purpose": "fine-tune"
}

curl "https://yunzhiapi.cn/v1/files/file-abc123" \
-H "Authorization: Bearer $API_KEY"

{
"id": "file-abc123",
"object": "file",
"bytes": 120000,
"created_at": 1710000000,
"filename": "train.jsonl",
"purpose": "fine-tune"
}

curl "https://yunzhiapi.cn/v1/files/file-abc123/content" \
-H "Authorization: Bearer $API_KEY" \
-o train.jsonl

curl -X DELETE "https://yunzhiapi.cn/v1/files/file-abc123" \
-H "Authorization: Bearer $API_KEY"

{
"id": "file-abc123",
"object": "file",
"deleted": true
}

curl "https://yunzhiapi.cn/v1/images/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "一只在月光下奔跑的柴犬，水彩风格",
"n": 1,
"size": "1024x1024"
}'

{
"created": 1710000000,
"data": [
{
"url": "https://example.com/gen/image-1.png",
"revised_prompt": "A Shiba Inu running under moonlight, watercolor style",
"media_type": "image",
"mime_type": "image/png"
}
]
}

curl "https://yunzhiapi.cn/v1/images/edits" \
-H "Authorization: Bearer $API_KEY" \
-F "image=@photo.png" \
-F "mask=@mask.png" \
-F "prompt=把天空替换为星空" \
-F "n=1" \
-F "size=1024x1024"

{
"created": 1710000000,
"data": [
{
"url": "https://example.com/gen/edited-1.png",
"media_type": "image",
"mime_type": "image/png"
}
]
}

curl "https://yunzhiapi.cn/v1/images/variations" \
-H "Authorization: Bearer $API_KEY" \
-F "image=@photo.png" \
-F "n=2"

{
"created": 1710000000,
"data": [
{
"url": "https://example.com/gen/variation-1.png",
"media_type": "image",
"mime_type": "image/png"
},
{
"url": "https://example.com/gen/variation-2.png",
"media_type": "image",
"mime_type": "image/png"
}
]
}

curl "https://yunzhiapi.cn/v1/audio/speech" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "你好，这是一段语音合成测试。",
"voice": "alloy",
"response_format": "mp3"
}' \
-o speech.mp3

curl "https://yunzhiapi.cn/v1/audio/transcriptions" \
-H "Authorization: Bearer $API_KEY" \
-F "file=@meeting.mp3" \
-F "model=whisper-1" \
-F "language=zh" \
-F "response_format=json"

{
"text": "大家好，今天我们讨论一下项目进度。"
}

curl "https://yunzhiapi.cn/v1/audio/translations" \
-H "Authorization: Bearer $API_KEY" \
-F "file=@speech.mp3" \
-F "model=whisper-1"

{
"text": "Hello everyone, today we will discuss the project progress."
}

curl "https://yunzhiapi.cn/v1/videos/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "海浪拍打礁石，慢镜头，电影质感",
"n": 1
}'

{
"created": 1710000000,
"data": [
{
"url": "https://example.com/gen/video-1.mp4",
"media_type": "video",
"mime_type": "video/mp4"
}
]
}

curl "https://yunzhiapi.cn/v1/videos" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "一只猫在窗边看雪，镜头缓慢推进"
}'

{
"id": "video_abc123",
"object": "video",
"model": "sora-2",
"status": "queued",
"created_at": 1710000000
}

curl "https://yunzhiapi.cn/v1/videos/video_abc123" \
-H "Authorization: Bearer $API_KEY"

{
"id": "video_abc123",
"object": "video",
"model": "sora-2",
"status": "completed",
"created_at": 1710000000,
"completed_at": 1710000060,
"data": [
{
"url": "https://example.com/gen/video-abc123.mp4",
"media_type": "video",
"mime_type": "video/mp4"
}
]
}

curl "https://yunzhiapi.cn/v1/videos?limit=20" \
-H "Authorization: Bearer $API_KEY"

curl -X DELETE "https://yunzhiapi.cn/v1/videos/video_abc123" \
-H "Authorization: Bearer $API_KEY"

curl https://yunzhiapi.cn/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"system": "你是一名严谨的助理。",
"messages": [
{"role": "user", "content": "用一句话介绍杭州。"}
],
"temperature": 0.7,
"stream": false
}'

curl https://yunzhiapi.cn/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"tools": [
{
"name": "get_weather",
"description": "查询城市实时天气",
"input_schema": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
],
"messages": [{"role": "user", "content": "北京天气如何？"}]
}'

"thinking": {
"type": "enabled",
"budget_tokens": 2048
}

{
"id": "msg_9f3a1c2e7b4d8f0a1b2c3d4e",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "杭州是浙江省省会，以西湖、龙井茶和数字经济闻名的历史文化名城。"
}
],
"model": "claude-sonnet-4-5",
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 28,
"output_tokens": 35,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}

event: message_start
data: {"type":"message_start","message":{"id":"msg_9f3a1c2e7b4d8f0a1b2c3d4e","type":"message","role":"assistant","content":[],"model":"claude-sonnet-4-5","stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":0,"output_tokens":0}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: ping
data: {"type":"ping"}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"杭州是浙江省省会，"}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"以西湖和数字经济闻名。"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":28,"output_tokens":35}}
event: message_stop
data: {"type":"message_stop"}

curl https://yunzhiapi.cn/v1/messages/count_tokens \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"system": "你是一名严谨的助理。",
"messages": [
{"role": "user", "content": "用一句话介绍杭州。"}
]
}'

{
"input_tokens": 21
}

curl https://yunzhiapi.cn/v1/models \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01"

{
"data": [
{
"type": "model",
"id": "claude-sonnet-4-5",
"display_name": "claude-sonnet-4-5",
"created_at": "2025-03-01T00:00:00Z"
},
{
"type": "model",
"id": "gpt-4o",
"display_name": "gpt-4o",
"created_at": "2025-03-01T00:00:00Z"
}
],
"has_more": false,
"first_id": "claude-sonnet-4-5",
"last_id": "gpt-4o"
}

x-goog-api-key: sk-你的密钥

curl "https://yunzhiapi.cn/v1beta/models/gemini-2.5-pro:generateContent" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"systemInstruction": {"parts": [{"text": "你是一名简洁的中文助手"}]},
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍量子计算"}]}
],
"generationConfig": {
"temperature": 0.7,
"topP": 0.95,
"maxOutputTokens": 1024
}
}'

curl "https://yunzhiapi.cn/v1beta/models/gemini-2.5-pro:generateContent" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"role": "user", "parts": [{"text": "北京天气如何？"}]}],
"tools": [
{
"functionDeclarations": [
{
"name": "get_weather",
"description": "查询城市实时天气",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}}
}
}
]
}
]
}'

"generationConfig": {
"responseMimeType": "application/json",
"responseSchema": {
"type": "object",
"properties": {
"name": {"type": "string"},
"age": {"type": "integer"}
},
"required": ["name", "age"]
}
}

{
"candidates": [
{
"content": {
"parts": [
{"text": "量子计算利用量子比特的叠加与纠缠特性，对特定问题实现远超经典计算机的并行求解能力。"}
],
"role": "model"
},
"finishReason": "STOP",
"index": 0,
"safetyRatings": []
}
],
"usageMetadata": {
"promptTokenCount": 24,
"candidatesTokenCount": 38,
"totalTokenCount": 62
},
"modelVersion": "gemini-2.5-pro"
}

curl "https://yunzhiapi.cn/v1beta/models/gemini-2.5-pro:streamGenerateContent" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "写一首关于春天的短诗"}]}
]
}'

data: {"candidates":[{"content":{"parts":[{"text":"春风"}],"role":"model"},"index":0,"safetyRatings":[]}]}
data: {"candidates":[{"content":{"parts":[{"text":"拂过柳梢，"}],"role":"model"},"index":0,"safetyRatings":[]}]}
data: {"candidates":[{"content":{"parts":[{"text":"唤醒一城新绿。"}],"role":"model"},"index":0,"safetyRatings":[]}]}
data: {"candidates":[{"content":{"parts":[{"text":""}],"role":"model"},"finishReason":"STOP","index":0,"safetyRatings":[]}],"usageMetadata":{"promptTokenCount":12,"candidatesTokenCount":18,"totalTokenCount":30}}

curl "https://yunzhiapi.cn/v1beta/models/gemini-2.5-pro:countTokens" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "用一句话介绍量子计算"}]}
]
}'

{
"totalTokens": 24
}

curl "https://yunzhiapi.cn/v1beta/models/imagen-3.0-generate-002:predict" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"instances": [
{"prompt": "一只在樱花树下打盹的橘猫，水彩风格"}
],
"parameters": {
"sampleCount": 1,
"aspectRatio": "16:9"
}
}'

{
"predictions": [
{
"bytesBase64Encoded": "iVBORw0KGgoAAAANSUhEUgAA...",
"mimeType": "image/png"
}
]
}

curl "https://yunzhiapi.cn/v1beta/models/veo-3.0-generate-001:predictLongRunning" \
-H "x-goog-api-key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"instances": [
{"prompt": "夕阳下海浪拍打礁石，电影感慢镜头"}
],
"parameters": {
"sampleCount": 1,
"durationSeconds": 8,
"aspectRatio": "16:9"
}
}'

{
"name": "operations/yz-550e8400-e29b-41d4-a716-446655440000",
"done": true,
"response": {
"@type": "type.googleapis.com/google.ai.generativelanguage.v1beta.PredictLongRunningResponse",
"generateVideoResponse": {
"generatedSamples": [
{
"video": {
"uri": "https://cdn.example.com/videos/abc123.mp4"
}
}
]
}
}
}

curl "https://yunzhiapi.cn/v1beta/models" \
-H "x-goog-api-key: sk-你的密钥"

{
"models": [
{
"name": "models/gemini-2.5-pro",
"version": "1.0",
"displayName": "gemini-2.5-pro",
"description": "Proxy model hosted by Yunzhi API",
"inputTokenLimit": 1048576,
"outputTokenLimit": 8192,
"supportedGenerationMethods": ["generateContent", "countTokens"],
"temperature": 1.0,
"topP": 0.95,
"topK": 40
}
]
}

HTTP/1.1 200 OK
Content-Type: text/event-stream; charset=utf-8
Cache-Control: no-cache, no-store, must-revalidate
Pragma: no-cache
Expires: 0
X-Accel-Buffering: no
Connection: keep-alive
Transfer-Encoding: chunked
X-Resume-Token: rst_9f2c…（32 位十六进制）

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","created":1721000000,"model":"gpt-4o","choices":[{"index":0,"delta":{"role":"assistant","content":"你好"},"finish_reason":null}]}
data: {"id":"chatcmpl-…","object":"chat.completion.chunk","created":1721000000,"model":"gpt-4o","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

const resp = await fetch("https://api.example.com/v1/chat/completions", {
method: "POST",
headers: {
"Authorization": "Bearer sk-xxx",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "gpt-4o",
stream: true,
messages: [{ role: "user", content: "你好" }]
})
});
const reader = resp.body.getReader();
const decoder = new TextDecoder();
let buf = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
buf += decoder.decode(value, { stream: true });
const events = buf.split("\n\n");
buf = events.pop();
for (const ev of events) {
for (const line of ev.split("\n")) {
if (!line.startsWith("data:")) continue;
const payload = line.slice(5).trim();
if (payload === "[DONE]") return;
const chunk = JSON.parse(payload);
const text = chunk.choices?.[0]?.delta?.content;
if (text) process.stdout.write(text);
}
}
}

import json
import requests
resp = requests.post(
"https://api.example.com/v1/chat/completions",
headers={"Authorization": "Bearer sk-xxx"},
json={
"model": "gpt-4o",
"stream": True,
"messages": [{"role": "user", "content": "你好"}],
},
stream=True,
timeout=600,
)
for line in resp.iter_lines(decode_unicode=True):
if not line or line.startswith(":"):
continue
if line.startswith("data:"):
payload = line[5:].strip()
if payload == "[DONE]":
break
chunk = json.loads(payload)
text = chunk["choices"][0]["delta"].get("content")
if text:
print(text, end="", flush=True)

X-Resume-Token: rst_4f8a2c1e9b7d3f605a8e1c2b4d6f8093

curl -N https://api.example.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-H "X-Resume-Token: rst_4f8a2c1e9b7d3f605a8e1c2b4d6f8093" \
-d '{"model":"gpt-4o","stream":true,"messages":[{"role":"user","content":"你好"}]}'

HTTP/1.1 200 OK
X-Idempotency-Hit: true
Content-Type: application/json; charset=utf-8

HTTP/1.1 429 Too Many Requests
Retry-After: 87
{
"error": {
"message": "Duplicate request is being processed.",
"type": "rate_limit_error",
"param": null,
"code": "YZ3008",
"request_id": "req_…",
"hint": "Use a unique X-Idempotency-Key for each distinct request."
}
}

import random
import time
import uuid
import requests
IDEMPOTENCY_KEY = str(uuid.uuid4())
def chat_with_retry(payload, max_retries=5):
url = "https://api.example.com/v1/chat/completions"
headers = {
"Authorization": "Bearer sk-xxx",
"Content-Type": "application/json",
"X-Idempotency-Key": IDEMPOTENCY_KEY,
}
for attempt in range(max_retries + 1):
try:
resp = requests.post(url, headers=headers, json=payload, timeout=600)
except requests.RequestException:
resp = None
if resp is not None and resp.status_code < 500 and resp.status_code != 429:
return resp
if attempt == max_retries:
break
if resp is not None and resp.headers.get("Retry-After"):
delay = float(resp.headers["Retry-After"])
else:
delay = min(0.5 * (2 ** attempt), 30) + random.uniform(0, 0.5)
time.sleep(delay)
return resp

: error {"code":"YZ5001","message":"AI service response timeout, please retry.","request_id":"req_..."}
data: [DONE]

event: error
data: {"type":"error","error":{"type":"api_error","message":"AI service response timeout, please retry. (code: YZ5001)"}}
event: message_stop
data: {"type":"message_stop"}

event: response.failed
data: {"type":"response.failed","response":{"id":"resp_...","status":"failed","error":{"code":"YZ5001","message":"AI service response timeout, please retry."}}}

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"status": "ok",
"timestamp": 1721000000
}

livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 30
readinessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 3
  periodSeconds: 10

pip install openai

npm install openai

from openai import OpenAI
client = OpenAI(
base_url="https://yunzhiapi.cn/v1",
api_key="sk-your-key",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
stream = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "写一首短诗"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)

import asyncio
from openai import AsyncOpenAI
client = AsyncOpenAI(
base_url="https://yunzhiapi.cn/v1",
api_key="sk-your-key",
)
async def main():
resp = await client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
asyncio.run(main())

import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://yunzhiapi.cn/v1",
apiKey: "sk-your-key",
});
const resp = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
const stream = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "写一首短诗" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

export OPENAI_BASE_URL="https://yunzhiapi.cn/v1"
export OPENAI_API_KEY="sk-your-key"

client = OpenAI(
base_url="https://yunzhiapi.cn/v1",
api_key="sk-your-key",
timeout=600.0,
max_retries=2,
)

pip install anthropic

npm install @anthropic-ai/sdk

import anthropic
client = anthropic.Anthropic(
base_url="https://yunzhiapi.cn",
api_key="sk-your-key",
)
msg = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
with client.messages.stream(
model="claude-sonnet-4-5",
max_tokens=1024,
messages=[{"role": "user", "content": "写一首短诗"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://yunzhiapi.cn",
apiKey: "sk-your-key",
});
const msg = await client.messages.create({
model: "claude-sonnet-4-5",
max_tokens: 1024,
messages: [{ role: "user", content: "你好" }],
});
console.log(msg.content[0].text);
const stream = client.messages.stream({
model: "claude-sonnet-4-5",
max_tokens: 1024,
messages: [{ role: "user", content: "写一首短诗" }],
});
for await (const event of stream) {
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
process.stdout.write(event.delta.text);
}
}

export ANTHROPIC_BASE_URL="https://yunzhiapi.cn"
export ANTHROPIC_API_KEY="sk-your-key"

pip install google-genai

npm install @google/genai

from google import genai
from google.genai import types
client = genai.Client(
api_key="sk-your-key",
http_options=types.HttpOptions(base_url="https://yunzhiapi.cn"),
)
resp = client.models.generate_content(
model="gemini-2.5-flash",
contents="你好",
)
print(resp.text)
for chunk in client.models.generate_content_stream(
model="gemini-2.5-flash",
contents="写一首短诗",
):
print(chunk.text, end="", flush=True)

import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
apiKey: "sk-your-key",
httpOptions: { baseUrl: "https://yunzhiapi.cn" },
});
const resp = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "你好",
});
console.log(resp.text);
const stream = await ai.models.generateContentStream({
model: "gemini-2.5-flash",
contents: "写一首短诗",
});
for await (const chunk of stream) {
process.stdout.write(chunk.text ?? "");
}

export GEMINI_API_KEY="sk-your-key"

import requests
url = "https://yunzhiapi.cn/v1/chat/completions"
headers = {
"Authorization": "Bearer sk-your-key",
"Content-Type": "application/json",
}
payload = {
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "你好"}],
}
try:
resp = requests.post(url, headers=headers, json=payload, timeout=60)
resp.raise_for_status()
print("X-Request-ID:", resp.headers.get("X-Request-ID", ""))
print(resp.json()["choices"][0]["message"]["content"])
except requests.HTTPError as e:
print("HTTP", e.response.status_code, e.response.text)
except requests.RequestException as e:
print("请求失败:", e)

const url = "https://yunzhiapi.cn/v1/chat/completions";
try {
const resp = await fetch(url, {
method: "POST",
headers: {
"Authorization": "Bearer sk-your-key",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好" }],
}),
});
console.log("X-Request-ID:", resp.headers.get("x-request-id") ?? "");
if (!resp.ok) {
throw new Error("HTTP " + resp.status + " " + (await resp.text()));
}
const data = await resp.json();
console.log(data.choices[0].message.content);
} catch (err) {
console.error("请求失败:", err.message);
}

<?php
$url = 'https://yunzhiapi.cn/v1/chat/completions';
$payload = json_encode([
'model' => 'gpt-4o-mini',
'messages' => [['role' => 'user', 'content' => '你好']],
]);
$requestId = '';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer sk-your-key',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$requestId) {
if (stripos($line, 'X-Request-ID:') === 0) {
$requestId = trim(substr($line, 13));
}
return strlen($line);
},
]);
$body = curl_exec($ch);
if ($body === false) {
fwrite(STDERR, '请求失败: ' . curl_error($ch) . PHP_EOL);
curl_close($ch);
exit(1);
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
echo 'X-Request-ID: ' . $requestId . PHP_EOL;
if ($status !== 200) {
fwrite(STDERR, 'HTTP ' . $status . ': ' . $body . PHP_EOL);
exit(1);
}
$data = json_decode($body, true);
echo $data['choices'][0]['message']['content'] . PHP_EOL;

package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"time"
)
func main() {
url := "https://yunzhiapi.cn/v1/chat/completions"
payload := map[string]interface{}{
"model": "gpt-4o-mini",
"messages": []map[string]string{
{"role": "user", "content": "你好"},
},
}
body, err := json.Marshal(payload)
if err != nil {
fmt.Println("序列化失败:", err)
return
}
req, err := http.NewRequest(http.MethodPost, url, bytes.NewReader(body))
if err != nil {
fmt.Println("构造请求失败:", err)
return
}
req.Header.Set("Authorization", "Bearer sk-your-key")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{Timeout: 60 * time.Second}
resp, err := client.Do(req)
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
respBody, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取响应失败:", err)
return
}
fmt.Println("X-Request-ID:", resp.Header.Get("X-Request-ID"))
if resp.StatusCode != http.StatusOK {
fmt.Printf("HTTP %d: %s\n", resp.StatusCode, string(respBody))
return
}
fmt.Println(string(respBody))
}

pip install langchain-openai llama-index llama-index-llms-openai-like
npm install @langchain/openai ai @ai-sdk/openai

from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="gpt-4o-mini",
api_key="sk-your-key",
base_url="https://yunzhiapi.cn/v1",
)
print(llm.invoke("你好").content)

import { ChatOpenAI } from "@langchain/openai";
const llm = new ChatOpenAI({
model: "gpt-4o-mini",
apiKey: "sk-your-key",
configuration: { baseURL: "https://yunzhiapi.cn/v1" },
});
const resp = await llm.invoke("你好");
console.log(resp.content);

from llama_index.core.llms import ChatMessage
from llama_index.llms.openai_like import OpenAILike
llm = OpenAILike(
model="gpt-4o-mini",
api_key="sk-your-key",
api_base="https://yunzhiapi.cn/v1",
is_chat_model=True,
)
resp = llm.chat([ChatMessage(role="user", content="你好")])
print(resp.message.content)

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
const gateway = createOpenAI({
baseURL: "https://yunzhiapi.cn/v1",
apiKey: "sk-your-key",
});
const { text } = await generateText({
model: gateway("gpt-4o-mini"),
prompt: "你好",
});
console.log(text);

spring:
ai:
openai:
api-key: sk-your-key
base-url: https://yunzhiapi.cnchat:
options:
model: gpt-4o-mini

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://yunzhiapi.cn", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")

export ANTHROPIC_BASE_URL="https://yunzhiapi.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

{
"env": {
"ANTHROPIC_BASE_URL": "https://yunzhiapi.cn",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
}
}

model = "gpt-4o"
model_provider = "custom"
[model_providers.custom]
name = "Custom"
base_url = "https://yunzhiapi.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

export OPENAI_API_KEY="sk-你的密钥"

docker run -d -p 3210:3210 \
-e OPENAI_API_KEY="sk-你的密钥" \
-e OPENAI_PROXY_URL="https://yunzhiapi.cn/v1" \
lobehub/lobe-chat

export BASE_URL="https://yunzhiapi.cn"
export OPENAI_API_KEY="sk-你的密钥"

docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL="https://yunzhiapi.cn/v1" \
-e OPENAI_API_KEY="sk-你的密钥" \
ghcr.io/open-webui/open-webui:main