Free.ai documentos
Inicio rápido en 60 segundos.
API de conversa compatíbel con OpenAI. Un token de portador, máis de 400 ferramentas. Execute este curl e siga lendo.
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!"}]}'
Que queres construír?
Inicios rápidos
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Xeración de imaxes
POST /v1/image/generate/
{
"model": "flux",
"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-large-v3"
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 recurren a un aviso en modo JSON que emite a mesma forma.
Si. Os modelos de conversas con capacidade de visión aceptan partes de contido image_ url (URLs ou base64). Para STT, POST o son como multipart/ form- data a /v1/stt/. Para PDF, use /v1/pdf/extract/ para OCR e converse sobre o resultado.
Un límite mensual de chamadas asociado ao seu plan (1. 000 gratuitas, 10. 000 básicas, 100. 000 profesionais, 1M empresariais) máis o saldo de tokens adquiridos. Non hai límite por segundo. O límite diario de chamadas gratuitas só se aplica ás solicitudes web, non ás chamadas API.
[Translation temporarily unavailable. Please try again.]
Asinamos cada webhook con HMAC- SHA256 sobre o corpo en bruto. A sinatura está na cabeceira X- Free- Signature (codificada en hexadecimal). Rexeita calquera carga cuxa sinatura non coincida con HMAC( o_ segredo_ do_ webhook, corpo_ en_ bruto).
[Translation temporarily unavailable. Please try again.]
O punto final / v1/ chat / acepta o esquema de solicitude OpenAI ChatCompletion e devolve a mesma forma de resposta. A maioría do código cliente OpenAI funciona cambiando dúas liñas: base_ url + api_ key.
Si, todos os modelos auto- hospedados 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, póñase en contacto connosco.
Os modelos auto- hospedados funcionan de balde no seu conxunto diario de 30. 000 tokens, e despois facturan a contaxe de tokens brutos. Os modelos premium pagan segundo o uso: 1, 50× o valor de venda, caendo a 1, 30× a $500/ 30d e 1, 15× a $2. 000/ 30d. O custo real é en cada páxina de modelo e en cada resposta API; as recargas de tokens comezan en $1.