Realiza tu primera solicitud a la API
Crea una clave API de ShareAI, elige un modelo disponible y envía una solicitud de chat desde tu servidor con autenticación Bearer.
En esta página
Comienza aquí cuando tu aplicación realice solicitudes utilizando una clave API desde tu propio espacio de trabajo de ShareAI. Necesitas una cuenta de ShareAI, una clave activa y acceso al modelo que deseas ejecutar.
1. Crear una clave API#
Abrir Consola de ShareAI y selecciona el espacio de trabajo que será propietario de la clave y el uso. Abre Claves API, elegir Crear clave API, dale a la clave un nombre reconocible y guarda el secreto en el entorno de tu servidor.


2. Elegir un modelo#
Abrir Modelos y copia el identificador exacto del modelo que se muestra allí. Verifica la disponibilidad actual y las restricciones del modelo/proveedor en tu clave. Un identificador en un tutorial antiguo no garantiza que la capacidad esté disponible hoy.
3. Enviar la solicitud#
https://api.shareai.now/api/v1/chat/completionsGenera una respuesta utilizando un modelo disponible.
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer
Reemplazar MODEL_IDENTIFIER con el identificador seleccionado. Configura SHAREAI_API_KEY en tu entorno antes de ejecutar el ejemplo.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. Leer el resultado#
Para una solicitud no transmitida exitosa, verifica que done sea true y lee el mensaje del asistente desde message.content. Verifica tanto el estado HTTP como cualquier objeto de error en el cuerpo antes de tratarlo como una finalización exitosa. Un resultado sin dispositivo puede llegar actualmente como un objeto de error con HTTP 200.
Si la solicitud falla#
| Estado | Próximo paso |
|---|---|
| 401 | Verifica la clave, el espacio de trabajo y el encabezado Authorization. |
| 402 | Verifica los créditos disponibles o el saldo aplicable. |
| 403 | Verifica los modelos y proveedores permitidos. |
| 429 | Espera Retry-After cuando esté presente, luego reintenta con un retraso limitado. |
| 503 | Verifica la capacidad actual o la disponibilidad del servicio; mantén un límite de reintentos. |
Próximos pasos#
Referencia de solicitud y respuesta de chat explica el cuerpo compatible. Si cada cliente debe autorizar su propia cuenta, sigue OAuth de la aplicación.
Última actualización septiembre 15, 2026