API文档 - sogoodsmart

概述

sogoodsmart API 采用 RESTful 风格，兼容 OpenAI 接口格式。您可以使用 OpenAI SDK 或任何兼容的 HTTP 客户端调用我们的 API。

BASE URL https://api.sogoodsmart.online/v1

      支持的数据格式
    

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

认证

所有 API 请求需要在 Header 中包含您的 API Key：

      cURL
      复制
    
# 认证示例
curl https://api.sogoodsmart.online/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

获取 API Key 登录控制台 → 设置 → API

登录后可在个人中心创建和管理您的 API Key。注意：API Key 只会显示一次，请妥善保存。

限流说明

套餐	请求限制	频率限制
免费版	100次/天	10次/分钟
专业版	10000次/天	60次/分钟
企业版	无限制	300次/分钟

💬 聊天接口

POST /chat/completions

创建聊天完成请求，兼容 OpenAI Chat API 格式

      请求示例
    
# 请求
POST /v1/chat/completions
{
  "model": "gpt-4o",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "你好，请介绍一下自己"}
  ],
  "temperature": 0.7,
  "max_tokens": 1000
}

请求参数

参数	类型	说明
model必填	string	模型名称，如 gpt-4o, claude-3-5-sonnet, gemini-1.5-pro
messages必填	array	消息数组，包含 role 和 content
temperature	float	温度参数 0-2，默认 0.7
max_tokens	integer	最大生成 token 数
stream	boolean	是否启用流式输出，默认 false

响应示例

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

📋 模型列表

GET /models

获取所有可用模型列表

      cURL
    
curl https://api.sogoodsmart.online/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

支持的模型分类

分类	模型示例
对话模型	gpt-4o, claude-3-5-sonnet, gemini-1.5-pro, deepseek-chat
图像生成	midjourney, flux-pro, dall-e-3, stable-diffusion-xl
视频生成	kling-3.0, runway-gen3, veo-3, lumal-dream-machine
语音合成	elevenlabs, eleven-multilingual, tts-1
音乐生成	suno-4.0, musicgen

🎨 图像生成

POST /images/generations

      请求示例
    
{
  "model": "flux-pro",
  "prompt": "A beautiful sunset over the ocean",
  "n": 1,
  "size": "1024x1024"
}

🎤 语音合成

POST /audio/speech

      请求示例
    
{
  "model": "eleven_multilingual",
  "input": "Hello, welcome to sogoodsmart!",
  "voice": " Rachel",
  "response_format": "mp3"
}

🐍 Python SDK

      安装
    
pip install openai

# 或安装 sogoodsmart SDK
pip install sogoodsmart

      Python 示例
    
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.sogoodsmart.online/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

📜 JavaScript SDK

      安装
    
npm install openai

      JavaScript 示例
    
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.sogoodsmart.online/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{role: 'user', content: 'Hello!'}]
});

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

💡 需要帮助？

如有疑问或需要技术支持，请联系 support@sogoodsmart.online

📚 API 开发文档

概述

认证