Documentación de la API
WorldAPI es compatible con OpenAI: usa cualquier SDK de OpenAI con otra base URL y tu clave de WorldAPI.
https://worldapi.cc/v1Inicio rápido
Crea una clave en el panel, expórtala como WORLDAPI_KEY y envía una solicitud de chat. Crear una clave
curl https://worldapi.cc/v1/chat/completions \
-H "Authorization: Bearer $WORLDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Write a haiku about the sea."}
],
"stream": true
}'from openai import OpenAI
client = OpenAI(
base_url="https://worldapi.cc/v1",
api_key="wapi-sk-...",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Summarize this in one line: ..."}],
)
print(resp.choices[0].message.content)
print(resp.usage) # prompt_tokens, completion_tokens, total_tokensimport OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://worldapi.cc/v1",
apiKey: process.env.WORLDAPI_KEY,
});
const stream = await client.chat.completions.create({
model: "gemini-3.5-flash-lite",
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Autenticación
Envía tu clave como token Bearer en la cabecera Authorization (también se acepta x-api-key). Las claves empiezan por wapi-sk- y se muestran una sola vez; revócalas y créalas de nuevo desde el panel.
Authorization: Bearer wapi-sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Modelos
Usa el id público de la tabla de tarifas como parámetro model. GET /v1/models devuelve la misma lista con precios. Ver la tabla completa
GET https://worldapi.cc/v1/models
gpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-minigpt-5gpt-5-minigpt-5-nanogpt-5.1gpt-5.1-codexgpt-5.2gpt-5.2-codexgpt-5.3-codexgpt-5.4gpt-5.4-minigpt-5.4-nanogpt-5.5gpt-5.6-lunagpt-5.6-solgpt-5.6-terragpt-oss-120bgpt-oss-20bclaude-3-haikuclaude-fable-5claude-fable-5.1claude-haiku-4.5claude-opus-4.1claude-opus-4.5claude-opus-4.6claude-opus-4.7claude-opus-4.8claude-opus-5claude-sonnet-4claude-sonnet-4.5claude-sonnet-4.6claude-sonnet-5gemini-2.5-flashgemini-2.5-flash-litegemini-3.1-flash-litegemini-3.1-progemini-3.5-flashgemini-3.5-flash-litegemini-3.6-flashgemini-3.7-flashgemini-3.8-flashgemma-4-26bdeepseek-v4-flashqwen3-235bqwen3-coderqwen3-next-80bqwen3-next-80b-thinkingglm-4.7glm-5kimi-k2-thinkingkimi-k2.5llama-3.1-70bminimax-m2grok-4.6nova-2-litenova-litenova-micronova-propalmyra-x5Facturación y uso
El uso se compra en paquetes antes de usarlo. Cada solicitud se valora por token y se consume de tu uso restante; sin uso restante la solicitud se rechaza con 402.
Cada modelo tiene su propio precio con descuento junto al precio oficial del proveedor; consulta la tabla de tarifas.
Las respuestas devuelven el objeto usage estándar de OpenAI (en streaming, en el último fragmento). El coste por solicitud se muestra en el panel.
"usage": {
"prompt_tokens": 120,
"completion_tokens": 48,
"total_tokens": 168
}Errores
Los errores usan el formato de OpenAI: { error: { message, type, code } }. Las solicitudes fallidas no se cobran.
| HTTP | code | Significado |
|---|---|---|
| 401 | invalid_api_key | Clave ausente, mal formada o revocada. |
| 402 | insufficient_balance | Saldo cero. Compra un paquete en el panel. |
| 404 | model_not_found | Id de modelo desconocido. |
| 429 | rate_limit_error | El proveedor limitó la solicitud. Reintenta con espera. |
| 502 / 504 | upstream_error | El proveedor falló o agotó el tiempo. No se cobra; reintenta. |
{
"error": {
"message": "No remaining usage on this account. Buy a usage pack at https://worldapi.cc/dashboard/billing.",
"type": "insufficient_quota",
"code": "insufficient_balance"
}
}Límites
- Cuerpos de hasta 6 MB; respuestas en streaming de hasta 5 minutos.
- Hasta 20 claves activas por cuenta.
- Los límites por cuenta siguen las cuotas de nube que tenemos; contacta con soporte para capacidad reservada.