Documentos de Free.ai
Inicio rápido en 60 segundos.
API de conversa compatíbel con OpenAI. Un token de portador, ferramentas 477. Execute este curl e logo siga lendo.
curl https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen7b","messages":[{"role":"user","content":"Hello!"}]}'Que queres construír?
Inicio rápido
Chat
POST /v1/chat/
{
"model": "qwen7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Xeración de imaxes
POST /v1/image/generate/
{
"model": "sdxl",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Editar a imaxe
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Texto a voz
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Fala a texto
POST /v1/stt/
multipart:
audio: <file>
model: "whisper"
language: "auto"Traducir
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Ir (chegando)
Ruby (próximo)
Ou empregar o SDK de OpenAI - apuntar base_ url en api. free.ai/ v1
Recetas
FAQ
Inscríbase en / signup /, confirme o seu correo electrónico e abra / account /? tab=api. Prema Xerar e aparecerá unha chave de portador (sk- free-...) Garde a chave - por seguridade só mostramos a chave completa unha vez.
JSON. A resposta / v1/ chat / reflicte a forma OpenAI: choices[]. message. content para o texto, máis un obxecto de uso que informa do custo do token. Os puntos finais de son + imaxe devolven un sobre JSON con output_ url, share_ url e credits_ used.
Si - pasar stream:true nas solicitudes de conversa. As respostas chegan como eventos enviados polo servidor co mesmo sobre data: {...} que o protocolo de transmisión OpenAI. A mensaxe final é data:[ DONE].
Si. Pasa unha matriz de ferramentas segundo o esquema de chamadas de ferramentas de OpenAI. Os modelos de chamadas de ferramentas nativas devolven chamadas_ ferramentas estruturadas; os modelos non nativos regresan a un aviso de modo JSON que emite a mesma forma.
Si. Os modelos de conversas con capacidade de visión aceptan partes do contido image_ url (URL ou base64). Para STT, POST audio como multipart/ form- data a /v1/stt/. Para PDF, use /v1/pdf/extract/ para OCR e converse sobre o resultado.
A monthly call cap tied to your plan (1,000 free, 10,000 Basic, 100,000 Pro, 1M Business). There's no per-second throttle. API calls to self-hosted models draw on your 30,000-token daily free pool first, then on your token balance, the same as on the website. Video generation is not part of the free API tier: an API key on an account with no token balance and no plan gets a 429 for video.
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.
Asinamos cada webhook con HMAC- SHA256 sobre o corpo en bruto. A sinatura está na cabeceira X- Free- Signature (codificada hexadecimal). Rexeita calquera carga cuxa sinatura non coincida con HMAC( o_ segredo_ do_ webhook, corpo_ en_ bruto).
{error:{message, type, code}}. 402 = out of tokens: daily pool and token balance both empty (response includes upgrade URL + shortfall in tokens). 429 = a limit was reached, such as the monthly call cap, or a tool that is not in your tier, such as video on a free API key. 400 = validation error. 5xx = our problem; retry with exponential backoff.
O punto final / v1/ chat/ acepta o esquema de solicitude ChatCompletion de OpenAI e devolve a mesma forma de resposta. A maioría do código de cliente de OpenAI funciona cambiando dúas liñas: base_ url + api_ key.
Si, todos os modelos autoaloxados son de código aberto (Apache 2.0 / MIT). O noso repositorio gpu_ api é público; cloneo, forneza a súa GPU e execute a mesma pila de inferencias. Para unha instalación en nube privada xestionada, contacte connosco.
Self-hosted models run free on your 30,000-token daily pool, then bill the raw token count. Video is the exception on the API: it needs a token balance or a plan, and one self-hosted Wan 2.2 or CogVideoX clip costs 30,000 tokens. Premium models are pay-as-you-go: 1.50× retail markup, dropping to 1.30× at $500/30d and 1.15× at $2,000/30d. Live cost is on every model page and on every API response; token top-ups start at $1.