玄矩AI API 文档

Authorization: Bearer sk-your-api-key-here

x-api-key: sk-your-api-key-here

curl -X POST https://hs32.com/api/coding/paas/v4/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "你好，请介绍一下自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1704067200,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是一个AI助手..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 50,
    "total_tokens": 70
  }
}

curl -X POST https://hs32.com/api/coding/paas/v4/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "写一首诗"}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

// 每个 chunk 格式：
data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"你"},"index":0}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"好"},"index":0}]}

// 最后一个 chunk（当 stream_options.include_usage=true）：
data: {"id":"chatcmpl-abc","choices":[{"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":10,"completion_tokens":20,"total_tokens":30}}

// 结束标记：
data: [DONE]

curl -X POST https://hs32.com/api/anthropic/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

curl -X POST https://hs32.com/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "What is the capital of France?",
    "instructions": "Answer concisely"
  }'

curl -X POST https://hs32.com/v1/embeddings \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen3-Embedding-4B",
    "input": ["钢结构设计规范适用于工业民用建筑", "今天天气很好"],
    "instruction": "根据句子检索相关段落"
}'

curl -X POST https://hs32.com/v1/rerank \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen3-Reranker-8B",
    "query": "什么是向量检索",
    "documents": ["向量检索按语义相似度匹配", "今天天气不错"],
    "top_n": 2
}'

curl -X POST https://hs32.com/api/coding/paas/v4/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Kwai-Kolors/Kolors",
    "prompt": "a beautiful sunset over the ocean, vibrant colors",
    "image_size": "1024x1024",
    "batch_size": 1,
    "num_inference_steps": 20,
    "guidance_scale": 7.5
  }'

{
  "images": [
    { "url": "https://cdn.example.com/generated-image.png" }
  ],
  "timings": { "inference": 3.2 },
  "seed": 12345
}

# 文本生成视频
curl -X POST https://hs32.com/api/coding/paas/v4/video/submit \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Wan-AI/Wan2.2-T2V-A14B",
    "prompt": "A cat walking on a sunny beach, cinematic",
    "image_size": "1280x720"
  }'

{
  "requestId": "video-abc123def456"
}

curl -X POST https://hs32.com/api/coding/paas/v4/video/status \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "video-abc123def456"
  }'

{
  "status": "InProgress",
  "reason": ""
}

{
  "status": "Succeed",
  "reason": "",
  "results": {
    "videos": [
      { "url": "https://cdn.example.com/video-abc123.mp4" }
    ],
    "timings": { "inference": 45.2 },
    "seed": 67890
  }
}

# 快速档
curl -X POST https://hs32.com/v1/audio/speech \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "F5-TTS-v1",
    "input": "你好，这是语音合成测试。"
}' -o out.wav

# 自然档（换 model 即可）
#   "model": "CosyVoice2-0.5B"

curl -X POST https://hs32.com/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=SenseVoiceSmall" \
  -F "file=@audio.wav"

# 获取所有模型
curl https://hs32.com/v1/models

# 仅获取图片模型
curl https://hs32.com/v1/models?type=image

# 仅获取聊天模型
curl https://hs32.com/v1/models?type=text&sub_type=chat

{
  "object": "list",
  "data": [
    { "id": "gpt-4o", "object": "model", "created": 1704067200, "owned_by": "openai" },
    { "id": "deepseek-chat", "object": "model", "created": 1704067200, "owned_by": "deepseek" }
  ]
}

{
  "error": {
    "message": "错误描述",
    "type": "error_type",
    "code": "error_code"
  }
}

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://hs32.com/api/coding/paas/v4"
)

# 非流式对话
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手"},
        {"role": "user", "content": "你好，请介绍一下自己"}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首关于春天的诗"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

response = client.images.generate(
    model="Kwai-Kolors/Kolors",
    prompt="a beautiful sunset over the ocean",
    size="1024x1024",
    n=1
)

print(response.data[0].url)

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://hs32.com/api/coding/paas/v4'
});

// 非流式对话
const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手' },
    { role: 'user', content: '你好，请介绍一下自己' }
  ]
});

console.log(response.choices[0].message.content);

const stream = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '写一首关于春天的诗' }],
  stream: true
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

# 查看模型列表
curl https://hs32.com/v1/models

# 健康检查
curl https://hs32.com/health

curl -X POST https://hs32.com/api/coding/paas/v4/chat/completions \
  -H "Authorization: Bearer sk-your-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", "description": "城市名称"}
          },
          "required": ["city"]
        }
      }
    }]
  }'

curl -X POST https://hs32.com/api/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your/image.png"

{
  "url": "https://mcp.0ki.cn/uploads/abc123.png",
  "filename": "abc123.png",
  "size": 12345
}