Documentación de API
Guías de integración detalladas y referencia de API para ayudarle a integrar rápidamente los servicios de API de IA de SiCore TokenWorks
1Inicio rápido
Usar la API de SiCore TokenWorks solo requiere tres simples pasos:
- Regístrese para obtener una cuenta de SiCore TokenWorks e inicie sesión en la consola
- Cree una clave de API en la consola
- Use su clave de API para llamar a nuestras interfaces
Tip: Los nuevos usuarios recibirán una cuota de prueba gratuita después del registro, sin necesidad de vincular una tarjeta de crédito para comenzar a usar.
2URL base
La URL base de la API es la siguiente; todas las solicitudes utilizan el protocolo HTTPS:
text
https://www.token8341.com/v1Interfaz de finalización de chat:
text
POST https://www.token8341.com/v1/chat/completionsNote: Esta interfaz es totalmente compatible con el formato de la interfaz Chat Completions de OpenAI; puede usar directamente el SDK de OpenAI para realizar llamadas.
3Método de autenticación
SiCore TokenWorks utiliza Bearer Token para la autenticación de API. Incluya su clave de API en el encabezado de la solicitud:
text
Authorization: Bearer sk-your-api-key-herePuede crear y gestionar sus claves en la página «API Keys» de la consola. Guarde su clave de API de forma segura y no la exponga en repositorios de código públicos o en código de cliente.
4Lista de modelos compatibles
| ID del modelo | Nombre del modelo | Proveedor |
|---|---|---|
| gpt-4o | GPT-4o | OpenAI |
| gpt-4o-mini | GPT-4o Mini | OpenAI |
| claude-3-5-sonnet | Claude 3.5 Sonnet | Anthropic |
| claude-4-sonnet | Claude 4 Sonnet | Anthropic |
| gemini-2-0-pro | Gemini 2.0 Pro | |
| deepseek-v4-pro | DeepSeek-V4-Pro | DeepSeek |
| qwen-max | Qwen-Max | Alibaba Cloud |
Se están integrando más modelos continuamente; preste atención a nuestros avisos de actualización.
5Código de ejemplo
curl
bash
curl https://www.token8341.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key-here" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'Python (openai SDK)
python
from openai import OpenAI
client = OpenAI(
base_url="https://www.token8341.com/v1",
api_key="sk-your-api-key-here"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "Hello!"}
]
)
print(response.choices[0].message.content)Node.js (openai SDK)
javascript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://www.token8341.com/v1",
apiKey: "sk-your-api-key-here",
});
const response = await client.chat.completions.create({
model: "gpt-4o",
messages: [
{ role: "user", content: "Hello!" },
],
});
console.log(response.choices[0].message.content);6Explicación de códigos de error
Cuando una solicitud de API falla, se devuelve el código de estado HTTP correspondiente y el mensaje de error, con el siguiente formato:
json
{
"error": {
"message": "Insufficient balance",
"type": "insufficient_balance",
"code": 402
}
}| Código de estado | Nombre | Descripción |
|---|---|---|
| 400 | Bad Request | 请求参数错误，请检查请求体格式 |
| 401 | Unauthorized | API Key 无效或缺失，请检查 Authorization 请求头 |
| 402 | Insufficient Balance | 账户余额不足，请充值后重试 |
| 404 | Not Found | 请求的模型或接口不存在 |
| 429 | Rate Limit | 请求频率过高，请稍后重试 |
| 500 | Internal Server Error | 服务内部错误，请联系技术支持 |
| 503 | Service Unavailable | 模型服务暂时不可用，请稍后重试 |
Preguntas frecuentes de integración
Preguntas frecuentes sobre API Key, cambio de modelo y lenguajes de integración
¿Una sola API Key puede invocar todos los modelos?
Sí. Esta es la característica principal de SiCore TokenWorks: los desarrolladores solo necesitan integrarse una vez para invocar todos los modelos de la plataforma, sin necesidad de solicitar cuentas ni gestionar Key por separado para cada proveedor.
¿Cambiar de modelo requiere modificar el código?
No es necesario modificar el código lógico, basta con cambiar un solo parámetro, el model ID, para alternar entre modelos nacionales e internacionales.
¿Qué lenguajes de programación son compatibles?
Se proporcionan ejemplos de integración para cURL, Python, Node.js y otros lenguajes principales, compatible con cualquier lenguaje que admita solicitudes HTTP y con el SDK oficial de OpenAI.
¿Cómo se autentica la API?
El método de autenticación es Bearer Token; basta con incluir la API Key en el encabezado de la solicitud. La interfaz es totalmente compatible con el formato Chat Completions de OpenAI, por lo que se puede invocar directamente con el SDK oficial de OpenAI sin necesidad de adaptaciones adicionales.
¿Hay SDK o ejemplos de código disponibles?
Sí. La plataforma ofrece ejemplos de integración para cURL, Python, Node.js y otros lenguajes principales, para que los desarrolladores elijan el suyo y realicen una integración rápida.
¿Se añadirán más modelos de forma continua? ¿Hay que modificar el código para los nuevos modelos?
Sí. La plataforma incorpora continuamente nuevos modelos nacionales e internacionales de referencia, manteniendo el mismo método de integración y sistema de facturación. Una vez lanzado un nuevo modelo, se puede seleccionar directamente sin modificar el código.
¿Cómo se utiliza el mecanismo de caché de la API de modelos grandes? ¿En qué escenarios se puede acertar en la caché?
La plataforma utiliza una caché compartida entre usuarios para el mismo prompt; al acertar en la caché, el precio se reduce más de un 90%, con un precio mínimo de caché de ¥0.010 por millón de Token, y la parte que acierta se factura al precio de caché. Es adecuado para escenarios en los que varios usuarios reutilizan el mismo prompt de prefijo, como indicaciones fijas del sistema, prefijos de conocimiento público, etc.: colocar la parte invariable al principio aumenta la tasa de acierto.
Si una llamada a la API falla o se agota el tiempo de espera, ¿cómo se implementan el reintento automático y la degradación?
La práctica habitual es: aplicar reintentos con retroceso exponencial ante tiempos de espera agotados y errores reintentables, y establecer un número máximo de reintentos; si aún falla, degradar a un modelo de respaldo. En la plataforma, cambiar de modelo solo requiere modificar el ID del modelo, sin cambios en el código; basta con escribir el destino de degradación como otro ID de modelo. Del lado de la plataforma también hay redundancia multinodo y enrutamiento inteligente entre regiones, y una anomalía en un solo nodo se conmuta automáticamente.
¿Cómo comparar el rendimiento y el costo de diferentes modelos?
Con una sola API Key se pueden invocar todos los modelos; cambiar de modelo solo requiere modificar el ID del modelo, sin cambios en el código, por lo que para hacer comparaciones horizontales no hace falta integrar cada modelo por separado. Se recomienda usar el mismo lote de muestras de negocio para llamar a cada uno, registrar la calidad de salida y el consumo, y luego comparar ítem por ítem el precio oficial con el precio de este sitio usando la «tabla comparativa de precios de todos los modelos» del sitio web oficial.
¿Cómo almacenar de forma segura la API Key en el servidor?
Se recomienda guardar la API Key solo en el servidor y enviarla en el encabezado de la solicitud como Bearer Token; no la incluyas en el código del frontend ni del cliente. Los datos de solicitud y respuesta de la plataforma se transmiten cifrados de extremo a extremo mediante HTTPS, y se ofrece gestión de permisos de nivel empresarial y registros de auditoría, por lo que los registros de llamadas son trazables.
En escenarios de alta concurrencia, ¿cómo se garantizan la estabilidad de las llamadas y una baja latencia?
La plataforma se apoya en centros de cómputo de zonas como Helinger en Mongolia Interior, Hami en Xinjiang y Zhongwei en Ningxia, y mediante algoritmos de programación propios realiza enrutamiento inteligente entre regiones y equilibrio de carga dinámico, con conmutación automática ante anomalías en un solo nodo; los usuarios de ciudades principales pueden obtener latencia de milisegundos, con un compromiso de disponibilidad del servicio del 99.9%. Se recomienda que el cliente complemente con reintentos con retroceso y degradación a varios modelos.
¿Cómo monitorear el volumen de llamadas, los costos y las anomalías?
La plataforma ofrece una cuenta unificada y un único sistema de facturación, con consumo transparente, saldo acreditado en tiempo real y consulta del detalle de consumo en cualquier momento; además, proporciona una función de registro de auditoría de las llamadas a la API, por lo que los registros de llamadas son trazables. Los usuarios empresariales que necesiten requisitos de cumplimiento más estrictos (gestión de permisos, registros de auditoría, etc.) pueden contactar con atención al cliente para coordinar con el área comercial.