Star API

主题

curl 示例 ​

本文档提供使用 curl 命令行工具调用 Star API 各个接口的完整示例。

前置准备 ​

确保您的系统已安装 curl。大多数操作系统已预装 curl。可通过以下命令检查：

bash
curl --version

提示

在 Windows 系统中，建议使用 PowerShell 或 Git Bash 运行 curl 命令。

认证 ​

所有请求都需要在请求头中携带 API Key：

bash
-H "Authorization: Bearer sk-your-api-key"

将 sk-your-api-key 替换为您在 Star API 控制台创建的 API Key。

聊天补全 ​

基本请求 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己。"}
    ]
  }'

带完整参数的请求 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "你是一个专业的技术顾问，用中文回答。"},
      {"role": "user", "content": "请解释什么是微服务架构，以及它的优缺点。"}
    ],
    "temperature": 0.7,
    "max_tokens": 500,
    "top_p": 1.0,
    "frequency_penalty": 0,
    "presence_penalty": 0
  }'

流式输出 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "写一首关于春天的诗。"}
    ],
    "stream": true
  }'

使用 Claude 模型 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "用中文解释什么是区块链技术。"}
    ]
  }'

使用 DeepSeek 模型 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "用 Python 写一个快速排序算法。"}
    ]
  }'

模型列表 ​

获取所有可用模型 ​

bash
curl https://star.zhxyclaw.cn/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

过滤输出（使用 jq） ​

bash
curl https://star.zhxyclaw.cn/v1/models \
  -H "Authorization: Bearer sk-your-api-key" | jq '.data[].id'

图像生成 ​

生成图像 ​

bash
curl https://star.zhxyclaw.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "dall-e-3",
    "prompt": "一只可爱的橘猫在阳光下打盹，水彩画风格",
    "n": 1,
    "size": "1024x1024",
    "quality": "standard"
  }'

文本嵌入 ​

获取文本嵌入 ​

bash
curl https://star.zhxyclaw.cn/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Star API 是一个统一的大模型接口网关"
  }'

语音转文字 ​

转录音频 ​

bash
curl https://star.zhxyclaw.cn/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-your-api-key" \
  -F file="@audio.mp3" \
  -F model="whisper-1" \
  -F language="zh"

指定输出格式 ​

bash
curl https://star.zhxyclaw.cn/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-your-api-key" \
  -F file="@audio.mp3" \
  -F model="whisper-1" \
  -F language="zh" \
  -F response_format="srt"

文字转语音 ​

生成语音 ​

bash
curl https://star.zhxyclaw.cn/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "tts-1",
    "input": "你好，欢迎使用 Star API！这是一个文字转语音的示例。",
    "voice": "alloy",
    "response_format": "mp3",
    "speed": 1.0
  }' \
  -o output.mp3

使用不同音色 ​

bash
# 使用女性音色 Nova
curl https://star.zhxyclaw.cn/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "tts-1",
    "input": "你好，欢迎使用 Star API！",
    "voice": "nova",
    "response_format": "mp3"
  }' \
  -o output_nova.mp3

常用技巧 ​

保存响应到文件 ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }' \
  -o response.json

格式化 JSON 输出（使用 jq） ​

bash
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }' | jq .

查看请求详情（调试） ​

bash
curl -v https://star.zhxyclaw.cn/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

使用环境变量 ​

bash
# 设置环境变量
export API_KEY="sk-your-api-key"

# 在请求中使用
curl https://star.zhxyclaw.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }'

下一步 ​

Star API - 统一的大模型接口网关

© 2026 Star API