旭恒数据 API 文档

Authorization: Bearer sk-你的密钥

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

from openai import OpenAI

client = OpenAI(
    base_url="https://www.xhoper.xyz/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

curl https://www.xhoper.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'

curl https://www.xhoper.xyz/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

{
  "object": "list",
  "data": [
    { "id": "gpt-4o-mini", "object": "model", "owned_by": "gateway", "created": 0 },
    { "id": "gpt-4o",      "object": "model", "owned_by": "gateway", "created": 0 }
  ]
}

{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "user", "content": "你好" }
  ]
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1793172218,
  "model": "gpt-4o-mini",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "你好！有什么可以帮你的？" },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

{
  "model": "gpt-4o-mini",
  "messages": [{ "role": "user", "content": "写一首短诗" }],
  "stream": true
}

from openai import OpenAI

client = OpenAI(base_url="https://www.xhoper.xyz/v1", api_key="sk-你的密钥")

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

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

{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "system",    "content": "你是一个简洁的助手" },
    { "role": "user",      "content": "什么是 REST？" },
    { "role": "assistant", "content": "REST 是一种网络架构风格。" },
    { "role": "user",      "content": "再简短一点" }
  ],
  "temperature": 0.7,
  "max_tokens": 200
}

{
  "model": "gpt-4o",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "这张图里有什么？" },
      { "type": "image_url", "image_url": { "url": "https://example.com/cat.jpg" } }
    ]
  }]
}

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }
}

{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "system", "content": "只输出 JSON，不要任何解释" },
    { "role": "user",   "content": "把「张三，28岁，北京」转成 JSON" }
  ],
  "response_format": { "type": "json_object" }
}

{
  "model": "gpt-4o-mini",
  "messages": [{ "role": "user", "content": "北京现在天气怎么样？" }],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "查询指定城市的天气",
      "parameters": {
        "type": "object",
        "properties": {
          "city": { "type": "string", "description": "城市名" }
        },
        "required": ["city"]
      }
    }
  }]
}

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://www.xhoper.xyz/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

npm i openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.xhoper.xyz/v1",
  apiKey: "sk-你的密钥",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

curl https://www.xhoper.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'

<?php
$ch = curl_init("https://www.xhoper.xyz/v1/chat/completions");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Authorization: Bearer sk-你的密钥",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "model" => "gpt-4o-mini",
        "messages" => [["role" => "user", "content" => "你好"]],
    ]),
]);
$resp = json_decode(curl_exec($ch), true);
echo $resp["choices"][0]["message"]["content"];

import time
from openai import OpenAI, APIStatusError, RateLimitError

client = OpenAI(base_url="https://www.xhoper.xyz/v1", api_key="sk-你的密钥")

def ask(prompt, retries=3):
    for i in range(retries):
        try:
            r = client.chat.completions.create(
                model="gpt-4o-mini",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(2 ** i)
        except APIStatusError as e:
            if e.status_code >= 500 and i < retries - 1:
                time.sleep(2 ** i)
            else:
                raise
    raise RuntimeError("重试次数用尽")

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["XHOPER_BASE_URL"],
    api_key=os.environ["XHOPER_API_KEY"],
)

client = OpenAI(
    base_url="https://www.xhoper.xyz/v1",
    api_key="sk-你的密钥",
    timeout=60.0,      # 总超时 60 秒
    max_retries=2,     # SDK 自动重试 2 次
)