API LLM gratuit cu apeluri de funcții
Apelul de funcții, sau tool calling, permite unui LLM să ceară rularea unei funcții din cod. Agenții, boturile de chat cu date live și extragerea structurată le folosesc pe toate. Catalogul FreeLLMAPI conține 190 oferte de modele gratuite cu apeluri de unelte. Trimiteți tools în stil OpenAI, iar gateway-ul le traduce pentru fiecare furnizor.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Cum funcționează apelurile de unelte prin FreeLLMAPI
- Trimiteți mesajele și o listă de
tools. Fiecare unealtă are un nume, o descriere și un JSON Schema pentru parametrii săi. - Modelul răspunde cu
tool_callsșifinish_reason: "tool_calls". El nu rulează nimic singur. - Codul rulează funcția și adaugă rezultatul ca mesaj cu
role: "tool". - Trimiteți din nou conversația. Modelul folosește rezultatul ca să scrie răspunsul final.
Furnizorii compatibili OpenAI, precum Groq, Cerebras, Mistral, OpenRouter și Cloudflare, primesc cererea așa cum este. Pentru Gemini, FreeLLMAPI traduce unealtele în formatul functionDeclarations de la Google și traduce răspunsul înapoi. Codul este același pentru fiecare furnizor.
Unele modele scriu un apel de unealtă ca text simplu, nu ca apel real de unealtă. FreeLLMAPI le detectează și le transformă în tool_calls reale.
Modele gratuite cu apeluri de unelte, astăzi
Tabelul arată cele mai puternice modele gratuite cu apeluri de unelte. Datele vin din catalogul activ. Pentru agenți, verificați și dimensiunea contextului, deoarece definițiile de unelte și rezultatele folosesc multe tokenuri.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 cereri/min 1 req/min per model | Da | Nu |
| Qwen3.8 Max | ACLIDE | - | €20/month shared internal usage credits · no card | Da | Nu |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 cereri/min 40 RPM | Da | Da |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Da | Da |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Da | Nu |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Da |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 cereri/min 50 cereri/zi Shared rate limit | Da | Nu |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Da | Da |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
Se afișează 15 din 146 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Pasul 1: Instalați FreeLLMAPI și adăugați chei
FreeLLMAPI este open source. Rulează pe computer, în Docker. Cheile furnizorilor rămân pe computer.
Instalare (macOS sau Linux)
curl -fsSL https://freellmapi.co/install.sh | bashDeschideți panoul la http://localhost:3001. Adăugați chei de la trei sau mai mulți furnizori pe pagina Keys. O buclă de unelte trimite mai multe cereri pentru o sarcină, deci mai multe chei dau mai mult spațiu. Copiați cheia unificată de pe aceeași pagină.
Pasul 2: Rulați o buclă completă de unelte
curl: prima cerere
curl http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{"role": "user", "content": "What is the weather in Karachi?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the current weather for a city.",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}]
}'Python: buclă până când modelul dă un răspuns final
import json
from openai import OpenAI
client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")
def get_weather(city: str) -> dict:
return {"city": city, "temp_c": 32, "condition": "sunny"} # call a real API here
FUNCS = {"get_weather": get_weather}
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get the current weather for a city.",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
messages = [{"role": "user", "content": "What is the weather in Karachi and Lahore?"}]
for _ in range(5): # stop after 5 rounds
msg = client.chat.completions.create(model="auto", messages=messages, tools=tools).choices[0].message
if not msg.tool_calls:
print(msg.content)
break
messages.append(msg)
for call in msg.tool_calls:
try:
args = json.loads(call.function.arguments or "{}")
result = FUNCS[call.function.name](**args)
except Exception as exc: # bad JSON, unknown tool or wrong arguments
result = {"error": str(exc)}
messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})Apelurile de unelte funcționează și cu stream=True. Primiți fragmente delta.tool_calls, apoi un fragment final cu finish_reason: "tool_calls". Uniți fragmentele de argumente înainte să parsați JSON-ul.
Folosiți o unealtă pentru date structurate
Apelurile de unelte sunt și o metodă bună de a obține date într-o formă fixă. Definiți o unealtă al cărei parametri sunt câmpurile pe care le doriți. Setați tool_choice la "required", astfel încât modelul trebuie să apeleze o unealtă. Apoi citiți argumentele. Nu trebuie să rulați nicio funcție.
Python: extrageți câmpuri cu un apel de unealtă obligatoriu
import json
from openai import OpenAI
client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")
schema = {
"type": "function",
"function": {
"name": "save_contact",
"description": "Save one contact found in the text.",
"parameters": {
"type": "object",
"properties": {"name": {"type": "string"}, "email": {"type": "string"}},
"required": ["name", "email"],
},
},
}
resp = client.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "Reach Sara Khan at [email protected]."}],
tools=[schema],
tool_choice="required",
)
print(json.loads(resp.choices[0].message.tool_calls[0].function.arguments))Validați argumentele cu propriul cod. Un model poate lăsa un câmp obligatoriu sau poate trimite un tip greșit. Dacă verificarea eșuează, trimiteți eroarea înapoi și cereți din nou.
Capcane
- Argumentele sunt un șir:
function.argumentseste un șir JSON. Parsați-l și prindeți erorile. Modelele mici trimit uneori JSON care nu este valid. - Potriviți ID-urile: fiecare mesaj de unealtă are nevoie de
tool_call_idal apelului său. Adăugați mesajul asistentului cutool_callsînainte de mesajele de unealtă. - Mai multe apeluri deodată: un model poate returna mai multe apeluri de unelte într-un singur răspuns. Rulați-le pe toate, apoi trimiteți toate rezultatele.
- Costul în tokenuri: fiecare definiție de unealtă se trimite cu fiecare cerere. Douăzeci de unelte mari pot folosi mii de tokenuri și pot atinge repede o limită scăzută de tokenuri pe minut. Trimiteți doar uneltele de care are nevoie sarcina.
- Descrieri clare: modelul alege o unealtă după nume și descriere. Scrieți o propoziție scurtă care spune ce face unealta și când se folosește.
- Opriți bucla: stabiliți un număr maxim de runde. Un model slab poate apela aceeași unealtă din nou și din nou.
- Modele fără unelte: unii furnizori gratuiți nu acceptă unelte. De exemplu, AI Horde elimină uneltele și răspunde ca un chat simplu.
Depanare
| Problemă | Cauză | Remediere |
|---|---|---|
| Modelul răspunde în text și nu apelează nicio unealtă | Modelul este slab la unelte, sau descrierea nu este clară | Fixați un model mai puternic din tabel sau îmbunătățiți descrierea uneltei |
json.JSONDecodeError la argumente | Modelul a trimis JSON nevalid | Prindeți eroarea și trimiteți-o înapoi ca rezultat al uneltei, ca modelul să poată încerca din nou |
| Eroare 400 despre un mesaj de unealtă | tool_call_id nu se potrivește, sau lipsește mesajul asistentului | Adăugați mai întâi mesajul asistentului, apoi câte un mesaj de unealtă pentru fiecare apel |
| Eroare 429 în timpul unei sarcini de agent | Bucla trimite multe cereri mari | Adăugați mai multe chei de furnizori și trimiteți mai puține unelte |
| Bucla nu se oprește | Modelul apelează din nou aceeași unealtă | Stabiliți o limită de runde și returnați rezultate clare |
Întrebări frecvente
Ce API-uri LLM gratuite acceptă apeluri de funcții?
Gemini, Groq, Cerebras, Mistral, OpenRouter, Cloudflare și alți furnizori au modele gratuite cu apeluri de unelte. Catalogul FreeLLMAPI conține 190 oferte de modele gratuite cu unelte, astăzi.
Este tool calling același lucru cu function calling?
Da. OpenAI a folosit primul numele function calling. API-ul actual folosește tools și tool_calls. Ambele nume înseamnă că modelul cere codului să ruleze o funcție.
Funcționează apelurile de unelte Gemini cu formatul OpenAI?
Da, prin FreeLLMAPI. Gateway-ul traduce uneltele OpenAI în functionDeclarations Gemini și traduce răspunsul înapoi în tool_calls OpenAI.
Pot transmite apelurile de unelte în streaming?
Da. Cu stream=True primiți fragmente delta.tool_calls și un finish_reason final de tool_calls. Uniți fragmentele de argumente înainte să le parsați.
Ghiduri înrudite
- Free LLM API pentru agenți AI
- API gratuit de căutare web pentru agenți AI
- Cele mai bune API-uri gratuite pentru modele de cod
- Free LLM API pentru LangChain
- API LLM gratuit în Python
Surse
- FreeLLMAPI docs: Tool calling (verificat 20 November 2026)
- FreeLLMAPI README: features (verificat 20 November 2026)
- OpenAI API reference: Chat Completions tools (verificat 20 November 2026)