Free.ai փաստաթղթեր

60 վայրկյանում արագ սկսել:

OpenAI-ի հետ համընկնող զրույցների API-ն։ Միակ Bearer token-ը, 400+ գործիքներ։ Փորձարկեք այս curl-ը, ապա կարդացեք ավելին։

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!"}]}'
Գրանցվել — կոդ ստանալ Պարզ աղբյուր

Ի՞նչ ես ուզում կառուցել։

Ես ուզում եմ զրուցել

POST /v1/chat/-ին հաղորդագրություններով։ Սփռել stream:true-ով։ Ընտրել 380+ մոդելներից մեկ ստորագրությամբ։

Ես ուզում եմ նկարներ ստեղծել

POST հրահանգ /v1/image/generate/-ին։ SDXL + FLUX ինքնահոսքային; բարձրորակ մոդելներ արտադրության մաքրման համար։

Ես ուզում եմ ներդնել @handle

Դիտարկեք AI անձնավորությունը, թողեք մեկ սյունակային սցենարի տեքստ ցանկացած էջում։ Գտնվողները զրուցում են ձեր AI- ի հետ, իսկ դուք ունեք խոսակցությունը։

Ճիշտ սկսել

Chat

POST /v1/chat/
{
  "model": "qwen2.5-7b",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}

Տեսանյութի ստեղծում

POST /v1/image/generate/
{
  "model": "flux",
  "prompt": "a quiet cabin at dusk",
  "width": 1024,
  "height": 1024
}

Տեսանյութի խմբագրում

POST /v1/image/edit/
multipart:
  image: <file>
  prompt: "remove the chair"
  operation: "edit"

Տեքստից խոսք

POST /v1/tts/
{
  "model": "kokoro",
  "voice": "af_heart",
  "text": "Hello there!"
}

Խոսքից տեքստ

POST /v1/stt/
multipart:
  audio: <file>
  model: "whisper-large-v3"
  language: "auto"

Թարգմանել

POST /v1/translate/
{
  "text": "Hello",
  "target_lang": "es"
}

SDK- ներ

Pythonpip install freeai-code Nodenpm i freeai-code Գնացեք Ruby (հաջորդում է) Կամ օգտագործեք OpenAI SDK-ն — մատնանշեք base_url-ը api.free.ai/v1 հասցեում

Առաջարկներ

Խոսակցություն

Փոխանցել հոսքը: ճիշտ. Կարդալ SSE-ի իրադարձությունները։ Տեսցնել ելքը, երբ այն գալիս է։

Ֆունկցիա

Տեղադրել գործիքների շարքը։ Մասնավորապես, մոդելը վերադարձնում է tool_calls։ Խնդրում է ձեր ֆունկցիան։ Վերահղում արդյունքը։

Ընդհանուր խմբագրում

Բեռնել աղբյուրային պատկերը + հարց. Վերցնել փոփոխված պատկերը։ Մասկը` ընտրյալ։

Բազմաբնակարան աշխատանքներ

Հղում CSV հարցումների. Webhook-ը գործում է յուրաքանչյուր կատարման ժամանակ. 50% զեղչ` կենդանի զանգերի համեմատ

Օգտագործել Webhook- ը

Կապել URL + գաղտնիքը։ Ստուգել HMAC-SHA256 ստորագրությունը յուրաքանչյուր բեռնման վրա։

@handle ներբեռնում

Ձեր գիտելիքները սովորեցրեք ինտելեկտուալ արարածին։ Գտնեք այն ցանկացած էջում մեկ սկրիպտի տեգով։

Ամբողջական API Հղում

Յուրաքանչյուր վերջնական կետ, յուրաքանչյուր պարամետր, յուրաքանչյուր պատասխանի ձև։ Հիմնական հղումը գտնվում է /api/ վայրում։

Փոխումների ցուցակ

Նոր մոդելներ, նոր վերջնական կետեր, ապշեցուցիչ փոփոխություններ... բոլորը այստեղ են։

Հաճախ տրվող հարցեր

Գրանցվեք /signup/ կայքում, հաստատեք Ձեր էլեկտրոնային հասցեն և բացեք /account/?tab=api։ Սեղմեք Ծնվել և կհայտնվի Ձեր կոդը (sk-free-...)։ Ստեղծեք այն, անվտանգության համար մենք ամբողջ կոդը ցույց ենք տալիս միայն մեկ անգամ։

JSON. /v1/chat/ պատասխանը կրկնօրինակում է OpenAI ձևը: text-ի համար choices[].message.content, plus a use object, որը հաղորդում է token cost-ը: Audio + image endpoints-ը վերադարձնում է JSON ծածկագիր output_url, share_url և credits_used-ով:

Այո — հաղորդել stream:true-ը զրույցների խնդրանքների դեպքում։ Պատասխանները գալիս են որպես սերվերի կողմից ուղարկված իրադարձություններ նույն տվյալների: {...} ծածկագրով, ինչ OpenAI-ի հոսքի պրոտոկոլը։ Վերջին հաղորդագրությունը data:[DONE] է։

Այո։ Տրամադրել գործիքների շարք՝ OpenAI գործիք-զանգահարող սխեմայի համաձայն։ Նոր-գործիք-զանգահարող մոդելները վերադարձնում են կառուցվածքավորված tool_calls; ոչ-նոր մոդելները վերադառնում են JSON-ռեժիմի հարցման, որը նույն ձևն է արտադրում։

Այո։ Վիդեո-կարողություն ունեցող զրույցների մոդելները ընդունում են image_url բովանդակության մասեր (URL-ներ կամ base64)։ STT-ի համար, POST ձայնը որպես multipart/form-data /v1/stt/-ում։ PDF-ի համար, օգտագործեք /v1/pdf/extract/ OCR-ի համար և զրույց ընթացեք արդյունքի մասին։

Ամսական զանգերի սահմանափակում, որը կապված է ձեր պլանի հետ (1000 անվճար, 10 Basic, 10 Pro, 1M Business) և ձեր գնած տոկոսադրույքը։ Ժամանակի առումով սահմանափակում չկա։ Ամենօրյա անվճար գումարը կիրառվում է միայն վեբ խնդրանքների համար, ոչ 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.

Մենք յուրաքանչյուր webhook-ը ստորագրում ենք HMAC-SHA256-ով` առանց մարմնի վրա։ Ցուցադրում ենք X-Free-Signature գլխամաս (հեքիաթային կոդավորում)։ Չընդունել ցանկացած payload, որի ստորագրությունը չի համապատասխանում HMAC(your_webhook_secret, raw_body)-ին։

{error:{message, type, code}}. 402 = out of credits (response includes upgrade URL + shortfall in tokens). 429 = daily pool exhausted (web only). 400 = validation error. 5xx = our problem; retry with exponential backoff.

/v1/chat/ վերջնական կետ ընդունում է OpenAI ChatCompletion խնդրանքի սխեման և վերադարձնում է նույն պատասխանի ձևը։ OpenAI-ի մուտքի կոդերի մեծ մասը աշխատում է երկու տող փոխելով՝ base_url + api_key։

Այո, յուրաքանչյուր ինքնուրույն ապահովված մոդել բաց կոդով է (Apache 2.0 / MIT)։ Մեր gpu_api ռեպոն հանրային է, կլոնեք այն, տրամադրեք ձեր GPU-ն և վարեք նույն inference stack-ը։ Փոխվարչապետված մասնավոր ամպային տեղադրման համար կապվեք մեզ հետ։

Ձեր սեփական մոդելները անվճար աշխատում են ձեր 30,000-տոկենային օրական ջրամբարի վրա, ապա հաշվարկվում են սորտային տոկենների քանակը։ Պրեմիում մոդելները վճարվում են, երբ դուք գնում եք: 1.50 × առևտրային արժեք, իջնում է 1.30 × $ 500 / 30d և 1.15 × $ 2,000 / 30d. Ցուցադրական արժեքը յուրաքանչյուր մոդելի էջում և յուրաքանչյուր API պատասխանում է; տոկենային վերականգնումները սկսվում են $ 1-ից:

Կարդացեք ամբողջական հղումը /api/ կայքում

Յուրաքանչյուր վերջնական կետ օրինակներով արձագանքներով, սխալ կոդերով և արագության սահմանափակումներով.

Բացել աղբյուրը Գինի & մակարդակներ

Սիրում ես Free.ai-ը, ասա ընկերներիդ։

Առաջարկել այս էջը