Free.ai Docs
Inicio rápido en 60 segundos.
API de chat compatible con OpenAI. Un token de portador, herramientas 477. Ejecute este rizo, y luego siga leyendo.
curl https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen2.5-7b","messages":[{"role":"user","content":"Hello!"}]}'¿Qué quieres construir?
Inicios rápidos
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Generación de imágenes
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Editar imagen
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Texto a discurso
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Discurso al texto
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Traducir
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
¡Vamos! ¡Vamos!
Ruby (se acerca)
O utilice el SDK de OpenAI — point base_url en api.free.ai/v1
Recetas
Preguntas frecuentes
Regístrese en /signup/, confirme su correo electrónico y abra /account/?tab=api. Haga clic en Generar y aparecerá una tecla de portador (sk-free-...). Guárdelo - para seguridad sólo mostraremos la clave completa una vez.
JSON. La respuesta /v1/chat/ refleja la forma OpenAI: elections[].message.content para el texto, además de un objeto de uso que reporta costo token. Audio + endpoints de imagen devuelven un sobre JSON con output_url, share_url y credits_used.
Sí — pass stream:true en solicitudes de chat. Las respuestas llegan como Eventos de Servidor-Enviado con los mismos datos: {...} sobre como el protocolo de streaming OpenAI. El mensaje final es data:[DONE].
Sí. Pase un array de herramientas por el esquema de llamadas a herramientas de OpenAI. Los modelos Native-tool-call devuelven tool_calls estructurados; los modelos no nativos vuelven a un prompt de modo JSON que emite la misma forma.
Sí. Los modelos de chat con capacidad de visión aceptan partes de contenido image_url (URLs o base64). Para STT, POST audio como multipart/form-data a /v1/stt/. Para PDF, use /v1/pdf/extract/ a OCR y chatee sobre el resultado.
Un límite de llamada mensual vinculado a su plan (1.000 gratis, 10.000 básicos, 100.000 Pro, 1M Business) más su saldo de token comprado. No hay acelerador por segundo. La piscina gratuita diaria sólo se aplica a las solicitudes web, no a las llamadas API.
freeai-code on npm + PyPI for our Coder IDE wrapper. For the raw API, the OpenAI SDKs (Python + Node) and most LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) work - set base_url to https://api.free.ai/v1 and your Bearer key.
Firmamos cada anzuelo web con HMAC-SHA256 sobre el cuerpo en bruto. La firma está en el encabezado X-Free-Signature (hex-encodificado). Rechazar cualquier carga útil cuya firma no coincida con HMAC(your_webhook_secret, raw_body).
{error:{mensaje, tipo, código. 402 = fuera de créditos (respuesta incluye actualización URL + déficit en tokens). 429 = grupo diario agotado (sólo web). 400 = error de validación. 5xx = nuestro problema; reintentar con retroceso exponencial.
El /v1/chat/ endpoint acepta el esquema de solicitud de ChatCompletion de OpenAI y devuelve la misma forma de respuesta. La mayoría de los códigos de cliente de OpenAI existentes funcionan cambiando dos líneas — base_url + api_key.
Sí — cada modelo auto hospedado es de código abierto (Apache 2.0 / MIT). Nuestro repo gpu_api es público; clonarlo, suministrar su GPU, y ejecutar la misma pila de inferencia. Para una instalación de nube privada administrada, póngase en contacto con nosotros.
Los modelos auto-alojados funcionan gratis en su piscina diaria de 30.000 tokens, luego facturan el recuento de tokens en bruto. Los modelos premium son de pago con cargo: 1,50 × marcado minorista, cayendo a 1,30 × a $500/30d y 1.15 × a $2.000/30d. El costo vivo está en cada página de modelo y en cada respuesta API; los complementos token comienzan a $1.