
Denne Gemini 4 Carbon API-guide fører dig fra en API-nøgle til en fungerende anmodning med cURL, Python OpenAI SDK og Googles native generateContent-format, alle med model-ID'et gemini-4-carbon. Hvert eksempel følger PoYo's offentliggjorte anmodningsskema pr. 16. november 2026. Du kan teste prompts på Gemini 4 Carbon-modelsiden først.
Ny med modellen? Start med Gemini 4 Carbon API-overblikket for grænser og placering.
Før du starter
Opret en nøgle i PoYo-dashboardet, og behold den på din server:
export POYO_API_KEY="your-poyo-key"
| Format | Endpoint | Brug det, når |
|---|---|---|
| Chat Completions | POST https://api.poyo.ai/v1/chat/completions | Du allerede bruger OpenAI SDK'et, beskeder kun med tekst |
| Gemini Native | POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent | Du har brug for billed- eller fildele (inlineData) |
| Gemini Native-streaming | POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:streamGenerateContent | Native format med server-sent events |
Hver anmodning sender Authorization: Bearer $POYO_API_KEY. gemini-4-carbon understøtter ikke /v1/responses eller /v1/messages på PoYo.
Første anmodning til Gemini 4 Carbon API med cURL
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-4-carbon",
"messages": [
{"role": "system", "content": "You are a code reviewer. Be specific and cite line numbers."},
{"role": "user", "content": "Review this function for race conditions: ..."}
],
"max_tokens": 8192,
"temperature": 1
}'
model og messages er påkrævede. Valgfrie felter i PoYo's skema: temperature (0–2), top_p (0–1, brug den eller temperature, ikke begge), max_tokens, stream, stop (op til 4 sekvenser), frequency_penalty og presence_penalty (−2 til 2) samt n. Hver beskeds content er en streng.
Svaret er et standard chat.completion-objekt: tekst i choices[0].message.content, stopårsagen i choices[0].finish_reason og antal i usage.prompt_tokens, usage.completion_tokens og usage.total_tokens.
Python med OpenAI SDK'et
Peg SDK'et mod PoYo, og lad alt andet være:
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
resp = client.chat.completions.create(
model="gemini-4-carbon",
messages=[
{"role": "system", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Write a migration plan from Celery 4 to Celery 5."},
],
max_tokens=8192,
)
print(resp.choices[0].message.content)
print(resp.choices[0].finish_reason, resp.usage.prompt_tokens, resp.usage.completion_tokens)
At skifte fra gemini-4-argon eller en anden model, der understøtter Chat Completions på PoYo, er en ændring på én linje i model.
Streaming med OpenAI SDK'et
Med stream=True sender PoYo chat.completion.chunk-events og slutter med data: [DONE]. Teksten kommer i choices[0].delta.content, og den sidste chunk indeholder finish_reason og usage:
stream = client.chat.completions.create(
model="gemini-4-carbon",
messages=[{"role": "user", "content": "Explain the CAP theorem with one example per trade-off."}],
max_tokens=4096,
stream=True,
)
usage = None
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
if getattr(chunk, "usage", None):
usage = chunk.usage
print("\n", usage)
Det Gemini-native generateContent-format
Det native endpoint tager modellen i URL-stien. Brødteksten bruger contents (hver med role user eller model og et parts-array) plus valgfri generationConfig (temperature, topP, topK, maxOutputTokens, stopSequences) og safetySettings:
curl "https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent" \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "List three risks of running database migrations during peak traffic."}]}
],
"generationConfig": {"maxOutputTokens": 2048, "temperature": 0.7}
}'
Svaret er Googles GenerateContentResponse-objekt, returneret direkte. Teksten står i candidates[].content.parts[].text, og antal står i usageMetadata. Tænkende modeller kan tilføje dele med thought: true eller en thoughtSignature, så spring dele uden tekst over:
import os, requests
URL = "https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent"
HEADERS = {"Authorization": f"Bearer {os.environ['POYO_API_KEY']}"}
body = {
"contents": [{"role": "user", "parts": [{"text": "Summarize the trade-offs of event sourcing."}]}],
"generationConfig": {"maxOutputTokens": 2048},
}
r = requests.post(URL, headers=HEADERS, json=body, timeout=600)
r.raise_for_status()
data = r.json()
text = "".join(
p["text"]
for c in data.get("candidates", [])
for p in c.get("content", {}).get("parts", [])
if "text" in p and not p.get("thought")
)
print(text)
print(data["usageMetadata"])
Native streaming
Skift metoden ud med :streamGenerateContent. Svaret er text/event-stream: hver data:-linje er et delvist GenerateContentResponse, det sidste event indeholder finishReason, og streamen slutter med data: [DONE]. Query-parameteren alt=sse accepteres, men er ikke påkrævet.
import json
STREAM_URL = "https://api.poyo.ai/v1beta/models/gemini-4-carbon:streamGenerateContent"
usage = {}
with requests.post(STREAM_URL, headers=HEADERS, json=body, stream=True, timeout=600) as r:
r.raise_for_status()
for line in r.iter_lines(decode_unicode=True):
if not line or not line.startswith("data: "):
continue
payload = line[len("data: "):]
if payload == "[DONE]":
break
event = json.loads(payload)
for cand in event.get("candidates", []):
for part in cand.get("content", {}).get("parts", []):
if "text" in part and not part.get("thought"):
print(part["text"], end="", flush=True)
usage = event.get("usageMetadata", usage)
print("\n", usage)
Multimodalt input via Gemini 4 Carbon API
Google angiver tekst, billede, lyd, video og PDF som inputtyper for Gemini 4 Carbon. På PoYo sendes filinput via det native format som en inlineData-del med en mimeType og base64-kodet data. PoYo's dokumentation viser et billedeksempel og anbefaler at placere tekstinstruktioner før mediedele:
{
"contents": [
{
"role": "user",
"parts": [
{"text": "Read this architecture diagram and list every service that writes to the database."},
{"inlineData": {"mimeType": "image/png", "data": "BASE64_IMAGE_DATA"}}
]
}
],
"generationConfig": {"maxOutputTokens": 4096}
}
PoYo's Chat Completions-skema dokumenterer content som en streng, så send ikke billedarrays i OpenAI-stil til /v1/chat/completions. For PDF, lyd og video viser PoYo's dokumentation ikke et separat eksempel; send først én lille fil, og tjek svaret, før du bygger en pipeline på det. Medier tæller med i prompten: usageMetadata.promptTokensDetails opdeler prompt-tokens efter modalitet.
Indstil maks. output
| Format | Felt | Tegn på, at outputtet blev afkortet |
|---|---|---|
| Chat Completions | max_tokens | finish_reason: "length" |
| Gemini Native | generationConfig.maxOutputTokens | finishReason forskellig fra STOP |
Google angiver 65.536 output-tokens som standardloftet for synkrone kald og en kontekst på 1.048.576 tokens delt mellem input og output. Googles prisside oplyser, at thinking-tokens afregnes til outputtaksten, så outputantallet i usage kan være større end den synlige tekst. PoYo's offentliggjorte skemaer har intet felt for tænkeniveau; feltet for maks. output er den dokumenterede længdestyring.
Læs forbruget, og beregn prisen for en anmodning
PoYo prissætter gemini-4-carbon til $1.60 pr. 1M input-tokens, $8.00 pr. 1M output-tokens og $0.08 pr. 1M cache-læste tokens (1 kredit = $0.005).
| Format | Input-tokens | Output-tokens (inkl. thinking) |
|---|---|---|
| Chat Completions | usage.prompt_tokens | usage.total_tokens − usage.prompt_tokens |
| Gemini Native | usageMetadata.promptTokenCount | totalTokenCount − promptTokenCount (svar plus thoughtsTokenCount) |
INPUT_USD, OUTPUT_USD = 1.60, 8.00 # PoYo, per 1M tokens
def carbon_cost_usd(input_tokens: int, output_tokens: int) -> float:
return (input_tokens * INPUT_USD + output_tokens * OUTPUT_USD) / 1_000_000
def carbon_cost_credits(input_tokens: int, output_tokens: int) -> float:
return carbon_cost_usd(input_tokens, output_tokens) / 0.005
Målt eksempel (PoYo produktion, 16. november 2026): en ikke-streamende /v1/chat/completions-anmodning, der bad gemini-4-carbon om at gennemgå en Python-funktion på 40 linjer, returnerede prompt_tokens: 480, completion_tokens: 1094 og total_tokens: 1574 på 6,3 sekunder uden rapporterede thinking-tokens. PoYo trak 1,904 kreditter, samme tal som formlen giver.
input: 480 × $1.60 / 1,000,000 = $0.000768 (0.1536 credits)
output: 1,094 × $8.00 / 1,000,000 = $0.008752 (1.7504 credits)
total: $0.009520 (1.9040 credits)
Dette prissætter hver prompt-token til den fulde inputtakst. Cache-læste tokens afregnes til $0.08 pr. 1M, men PoYo's svarskemaer dokumenterer ikke et felt for cachede tokens, så betragt formlen som en øvre grænse. Prisscenarier i større skala findes i Gemini 4 Carbon API-priser.
Fejl, der er værd at håndtere
LLM-endpoints på PoYo returnerer rigtige HTTP-statuskoder:
| HTTP | Årsag | Hvad du skal gøre |
|---|---|---|
| 400 | Manglende eller ugyldigt felt; brødtekst {"code": 400, "error": {"type": "validation_error", ...}} | Ret anmodningen; læs error.details |
| 400 | Forkert format for denne model; beskeden oplister de understøttede URI'er | Brug Chat Completions eller Gemini Native |
| 400 | Gemini Native-fejl i Googles struktur {"error": {"code": 400, "message": "...", "status": "INVALID_ARGUMENT"}} | Ret contents / generationConfig |
| 401 | Manglende eller ugyldig API-nøgle | Tjek Authorization-headeren |
| 402 | Utilstrækkelige kreditter | Fyld op, før du prøver igen |
| 404 | Ukendt model-ID (model_not_found) | Tjek stavemåden: gemini-4-carbon |
| 500 / 502 / 503 | Server- eller upstream-fejl | Prøv igen med eksponentiel backoff |
PoYo's dokumentation siger, at LLM-endpoints i øjeblikket ikke er rate limited, men PoYo's generelle fejlkoder omfatter 429. Håndter den med en pause og et nyt forsøg. Med OpenAI SDK'et fanger du openai.APIStatusError og forgrener på status_code. Se PoYo-fejlkoder for de fulde brødtekster.
Tjekliste, før du går i produktion
- Behold
POYO_API_KEYpå serversiden; send den aldrig med i browser- eller mobilkode. - Sæt altid
max_tokensellermaxOutputTokens, og logfinish_reason/finishReason, så afkortede svar er synlige. - Gem usage-blokken fra hvert svar sammen med det anmodnings-ID, du tildeler, så du kan afstemme forbruget pr. funktion.
- Placer lang, stabil kontekst (repository-filer, dokumenter) først og det skiftende spørgsmål sidst, så implicit caching har en chance for at slå til.
- Prøv kun igen ved 5xx- og
429-svar; en 400 fejler igen, indtil brødteksten ændres.
Til agentløkker, værktøjsoutput og mønstre med lang kontekst, fortsæt med Gemini 4 Carbon API til kodeagenter. For at afgøre, hvornår Argon er nok, læs Gemini 4 Carbon API vs Gemini 4 Argon.
Ofte stillede spørgsmål
Hvordan kalder jeg Gemini 4 Carbon API i Python?
Brug OpenAI SDK'et med base_url="https://api.poyo.ai/v1", din PoYo-nøgle og model="gemini-4-carbon". Til native anmodninger sender du en POST til /v1beta/models/gemini-4-carbon:generateContent med requests.
Understøtter Gemini 4 Carbon API streaming?
Ja. Sæt "stream": true på Chat Completions, eller kald :streamGenerateContent i det native format. Begge returnerer server-sent events, der slutter med data: [DONE].
Hvordan sender jeg et billede til Gemini 4 Carbon API?
Brug det Gemini-native endpoint med en inlineData-del (mimeType plus base64-kodet data) efter din tekstdel. Chat Completions på PoYo tager kun strengindhold.
Hvordan begrænser jeg antallet af output-tokens i Gemini 4 Carbon API?
Sæt max_tokens (Chat Completions) eller generationConfig.maxOutputTokens (native). Thinking-tokens afregnes som output, så sammenlign outputantallet i usage med den synlige tekst, når du vælger loftet.
Hvorfor returnerer Gemini 4 Carbon API 400 på /v1/responses?
gemini-4-carbon understøtter kun Chat Completions og Gemini Native på PoYo. Andre formater returnerer 400 med listen over understøttede URI'er.