curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-3.6-flash",
"messages": [
{
"role": "user",
"content": "Please introduce yourself"
}
]
}
'{
"id": "chatcmpl-20251010015944503180122WJNB8Eid",
"model": "gemini-3.6-flash",
"object": "chat.completion",
"created": 1760032810,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google.\n\nSimply put, you can think of me as a \"smart brain\" that has been trained on massive amounts of text data and is able to understand and generate human language. My core capability is processing and generating text. Specifically, I can do the following:\n\n**1. Information Query & Knowledge Answering**\nI can act like a \"talking encyclopedia,\" answering various questions, whether they're about scientific knowledge, historical events, or everyday facts.\n\n**2. Creative Writing & Text Generation**\nI can create various types of text based on your requirements, such as:\n* **Writing**: Poetry, stories, scripts, emails, speeches, advertising copy, etc.\n* **Planning**: Travel plans, study outlines, event proposals, etc.\n* **Brainstorming**: Working with you to generate new ideas and spark creativity.\n\n**3. Translation & Language Processing**\nI'm proficient in multiple languages and can provide fast, fluent translation services. I can also help you polish, proofread, summarize, or rewrite text to make your expression clearer and more professional.\n\n**4. Programming & Code Assistance**\nI can write code snippets, explain code logic, debug errors, or \"translate\" code from one programming language to another, making me a helpful companion for programmers.\n\n**5. Logical Analysis & Reasoning**\nI can help you analyze complex problems, organize logical chains, and make inferences and summaries based on the information you provide.\n\n---\n\n**In summary**, my goal is to be a powerful and useful tool that helps you obtain information more efficiently, complete tasks, and spark creativity through natural language communication.\n\n**Remember:** I'm an artificial intelligence, my knowledge comes from the data I've learned, and it may not be the most up-to-date. Sometimes I may also make mistakes, so for very important information, I recommend you verify it again.",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"logprobs": {
"content": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
],
"top_logprobs": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
]
}
]
}
]
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 13,
"completion_tokens": 1891,
"total_tokens": 1904,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 13,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 1480
},
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": null
}
}{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}{
"error": {
"code": 401,
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": 402,
"message": "Unzureichendes Kontingent",
"type": "insufficient_quota_error",
"fallback_suggestion": "https://evolink.ai/dashboard/billing"
}
}{
"error": {
"code": 403,
"message": "Access denied for this model",
"type": "permission_error",
"param": "model"
}
}{
"error": {
"code": 404,
"message": "Specified model not found",
"type": "not_found_error",
"param": "model",
"fallback_suggestion": "gemini-3.6-flash"
}
}{
"error": {
"code": 413,
"message": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"error": {
"code": 429,
"message": "Ratenlimit überschritten",
"type": "rate_limit_error",
"fallback_suggestion": "retry after 60 seconds"
}
}{
"error": {
"code": 500,
"message": "Interner Serverfehler",
"type": "internal_server_error",
"fallback_suggestion": "try again later"
}
}{
"error": {
"code": 502,
"message": "Upstream AI service unavailable",
"type": "upstream_error",
"fallback_suggestion": "try different model"
}
}{
"error": {
"code": 503,
"message": "Dienst vorübergehend nicht verfügbar",
"type": "service_unavailable_error",
"fallback_suggestion": "retry after 30 seconds"
}
}Gemini Schnittstelle für alle Modelle - OpenAI-kompatibles Format
Wählen Sie über model im Anfragekörper das aufzurufende Gemini-Textmodell aus (alle möglichen Werte finden Sie in der Vergleichstabelle des Parameters model).
- Verwendet das OpenAI-SDK-/Chat-Completions-Format und gibt Gesprächsinhalte synchron zurück
- Reiner Text / multimodale Eingabe: gemischte Eingabe aus Text + Bild (
messages[].content) - Streaming: Setzen Sie
stream: true, um blockweise zurückzugeben
Modellspezifikationen und Unterschiede
- Verhalten von 3.8: Im Vergleich zu 3.7 bietet das Modell bessere Softwareentwicklung, Agentenfähigkeiten, mehrstufiges Reasoning und multimodale Genauigkeit; insbesondere bei
highkann es mehr Reasoning- / Ausgabe-Token verbrauchen. Für latenzkritische Szenarien wirdlow, für allgemeine Aufgaben der Standardwertmediumund für komplexen Code, lange Videos oder mehrstufiges Reasoninghighempfohlen. - Sampling- / Straf-Parameter
temperature/top_p/frequency_penalty/presence_penalty: Bei der gesamten Gemini-3.x-Serie einheitlich, benutzerdefinierte Werte beeinflussen die Ausgabe nicht;temperature/top_paußerhalb des Bereichs geben einen 400 zurück,frequency_penalty/presence_penaltywerden ignoriert und haben keine Wirkung (ohne Fehler). - Denksteuerung
reasoning_effort:minimal/low/medium/high(die von jedem Modell unterstützten Stufen und Standardwerte siehe Parameterreasoning_effort); wirkt nur bei der Gemini-3.x-Serie.gemini-3.8-flash/gemini-3.7-flashund die Pro-Serie unterstützenminimalnicht; ein übergebener Wert wird automatisch auflowherabgestuft. - Rolle der letzten Runde: Die
roleder letzten Nachricht darf nichtassistantsein (Gemini 3.5+ gibt sonst einen Fehler zurück). - Token-Obergrenze:
gemini-3.8-flash/gemini-3.7-flash/gemini-3.6-flash/gemini-3.5-flash-liteKontext 1,048,576, maximale Ausgabe 65,536; bei allen anderen Modellen gelten die jeweiligen Spezifikationen.
curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-3.6-flash",
"messages": [
{
"role": "user",
"content": "Please introduce yourself"
}
]
}
'{
"id": "chatcmpl-20251010015944503180122WJNB8Eid",
"model": "gemini-3.6-flash",
"object": "chat.completion",
"created": 1760032810,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google.\n\nSimply put, you can think of me as a \"smart brain\" that has been trained on massive amounts of text data and is able to understand and generate human language. My core capability is processing and generating text. Specifically, I can do the following:\n\n**1. Information Query & Knowledge Answering**\nI can act like a \"talking encyclopedia,\" answering various questions, whether they're about scientific knowledge, historical events, or everyday facts.\n\n**2. Creative Writing & Text Generation**\nI can create various types of text based on your requirements, such as:\n* **Writing**: Poetry, stories, scripts, emails, speeches, advertising copy, etc.\n* **Planning**: Travel plans, study outlines, event proposals, etc.\n* **Brainstorming**: Working with you to generate new ideas and spark creativity.\n\n**3. Translation & Language Processing**\nI'm proficient in multiple languages and can provide fast, fluent translation services. I can also help you polish, proofread, summarize, or rewrite text to make your expression clearer and more professional.\n\n**4. Programming & Code Assistance**\nI can write code snippets, explain code logic, debug errors, or \"translate\" code from one programming language to another, making me a helpful companion for programmers.\n\n**5. Logical Analysis & Reasoning**\nI can help you analyze complex problems, organize logical chains, and make inferences and summaries based on the information you provide.\n\n---\n\n**In summary**, my goal is to be a powerful and useful tool that helps you obtain information more efficiently, complete tasks, and spark creativity through natural language communication.\n\n**Remember:** I'm an artificial intelligence, my knowledge comes from the data I've learned, and it may not be the most up-to-date. Sometimes I may also make mistakes, so for very important information, I recommend you verify it again.",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"logprobs": {
"content": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
],
"top_logprobs": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
]
}
]
}
]
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 13,
"completion_tokens": 1891,
"total_tokens": 1904,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 13,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 1480
},
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": null
}
}{
"error": {
"code": 400,
"message": "Ungültige Anfrageparameter",
"type": "invalid_request_error"
}
}{
"error": {
"code": 401,
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": 402,
"message": "Unzureichendes Kontingent",
"type": "insufficient_quota_error",
"fallback_suggestion": "https://evolink.ai/dashboard/billing"
}
}{
"error": {
"code": 403,
"message": "Access denied for this model",
"type": "permission_error",
"param": "model"
}
}{
"error": {
"code": 404,
"message": "Specified model not found",
"type": "not_found_error",
"param": "model",
"fallback_suggestion": "gemini-3.6-flash"
}
}{
"error": {
"code": 413,
"message": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"error": {
"code": 429,
"message": "Ratenlimit überschritten",
"type": "rate_limit_error",
"fallback_suggestion": "retry after 60 seconds"
}
}{
"error": {
"code": 500,
"message": "Interner Serverfehler",
"type": "internal_server_error",
"fallback_suggestion": "try again later"
}
}{
"error": {
"code": 502,
"message": "Upstream AI service unavailable",
"type": "upstream_error",
"fallback_suggestion": "try different model"
}
}{
"error": {
"code": 503,
"message": "Dienst vorübergehend nicht verfügbar",
"type": "service_unavailable_error",
"fallback_suggestion": "retry after 30 seconds"
}
}https://direct.evolink.ai und bietet bessere Unterstützung für Textmodelle sowie persistente Verbindungen. https://api.evolink.ai ist der primäre Endpunkt für multimodale Dienste und dient bei Textmodellen als Ausweichadresse.Autorisierungen
##Alle APIs erfordern Bearer-Token-Authentifizierung##
API-Schlüssel erhalten:
Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten
Zum Anfrage-Header hinzufügen:
Authorization: Bearer YOUR_API_KEY
Body
Wählen Sie das aufzurufende Gemini-Textmodell aus:
| Modell-ID | Serie | Positionierung |
|---|---|---|
gemini-3.8-flash | 3.8 Flash | Verbesserte Softwareentwicklung / Agents / mehrstufiges Reasoning / multimodale Genauigkeit |
gemini-3.7-flash | 3.7 Flash | Agentic auf Pro-Niveau / Codegenerierung / Terminal-Ausführung |
gemini-3.6-flash | 3.6 Flash | Mehrschritt-Orchestrierung / Code-Refactoring / allgemeines Reasoning |
gemini-3.5-flash | 3.5 Flash | Universal-Flash |
gemini-3.5-flash-lite | 3.5 Flash-Lite | Niedrige Kosten / hoher Durchsatz / leichtgewichtiger Agent |
gemini-3.1-pro-preview | 3.1 Pro (Preview) | Fortgeschrittenes Reasoning |
gemini-3.1-pro-preview-customtools | 3.1 Pro · CustomTools | Fortgeschrittenes Reasoning + benutzerdefinierte Tools |
gemini-3.1-flash-lite-preview | 3.1 Flash-Lite (Preview) | Niedrige Kosten |
gemini-3-pro-preview | 3.0 Pro (Preview) | Fortgeschrittenes Reasoning |
gemini-3-flash-preview | 3.0 Flash (Preview) | Universal-Flash |
gemini-2.5-pro | 2.5 Pro | Fortgeschrittenes Reasoning |
gemini-2.5-flash | 2.5 Flash | Universal-Flash |
gemini-2.5-flash-lite | 2.5 Flash-Lite | Niedrige Kosten |
gemini-3.8-flash, gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3.1-pro-preview, gemini-3.1-pro-preview-customtools, gemini-3.1-flash-lite-preview, gemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite "gemini-3.6-flash"
Liste der Chat-Nachrichten, unterstützt Mehrrunden-Dialog und multimodale Eingabe
1Show child attributes
Show child attributes
Ob die Antwort im Streaming-Modus zurückgegeben werden soll
true: Streaming-Rückgabe, empfängt Inhalte in Echtzeit-Blöckenfalse: Gibt die vollständige Antwort auf einmal zurück
false
Maximum number of completion tokens for the generated response, corresponding to Gemini's maxOutputTokens.
gemini-3.8-flash / gemini-3.7-flash / gemini-3.6-flash / gemini-3.5-flash-lite Obergrenze 65,536 Token; bei allen anderen Modellen gelten die jeweiligen Spezifikationen.
1 <= x <= 655362000
Maximum number of tokens for the generated response, compatible with the legacy OpenAI parameter.
1 <= x <= 655362000
Sampling-Temperatur, steuert die Zufälligkeit der Ausgabe
Beschreibung:
- Niedrigere Werte (z. B. 0.2): Deterministischere, fokussiertere Ausgabe
- Höhere Werte (z. B. 1.5): Zufälligere, kreativere Ausgabe
Bei der gesamten Gemini-3.x-Serie einheitlich (nicht modellabhängig): Benutzerdefinierte Werte innerhalb des gültigen Bereichs beeinflussen die Ausgabe nicht; Werte außerhalb des gültigen Bereichs dieses Parameters geben einen 400 zurück, statt still ignoriert zu werden.
0 <= x <= 20.7
Nucleus-Sampling-Parameter
Beschreibung:
- Steuert das Sampling aus den Token mit der höchsten kumulativen Wahrscheinlichkeit
- Zum Beispiel bedeutet 0.9, dass aus Token mit einer kumulativen Wahrscheinlichkeit von bis zu 90% ausgewählt wird
- Standardwert: 0.95
Empfehlung: Passen Sie temperature und top_p nicht gleichzeitig an
Bei der gesamten Gemini-3.x-Serie einheitlich (nicht modellabhängig): Benutzerdefinierte Werte innerhalb des gültigen Bereichs beeinflussen die Ausgabe nicht; Werte außerhalb des gültigen Bereichs dieses Parameters geben einen 400 zurück, statt still ignoriert zu werden.
0 <= x <= 10.9
Frequency penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's frequencyPenalty.
Bei der gesamten Gemini-3.x-Serie einheitlich: Übergebene Werte werden ignoriert und haben keine Wirkung (ohne Fehler).
-2 <= x <= 20
Presence penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's presencePenalty.
Bei der gesamten Gemini-3.x-Serie einheitlich: Übergebene Werte werden ignoriert und haben keine Wirkung (ohne Fehler).
-2 <= x <= 20
Stop sequences. Supports a string or string array, corresponding to Gemini's stopSequences.
Anzahl der zu generierenden Kandidaten
Gemini 3.x unterstützt nur 1; das Übergeben von >1 gibt einen 400 zurück (entspricht dem in der nativen API bereits entfernten candidateCount).
1 <= x <= 11
Begrenzt den Denkaufwand, entspricht der Denkebene von Gemini:
minimal: nahezu kein Denken, hoher Durchsatz / geringe Latenzlow: weniger Denken, einfache Aufgabenmedium: ausgewogenes Verhältnis von Qualität und Geschwindigkeithigh: tiefes mehrstufiges Reasoning
Wirkt nur bei der Gemini-3.x-Serie, die unterstützten Stufen und Standardwerte unterscheiden sich je nach Modell (identisch mit der nativen API):
| Modell | Unterstützte Stufen | Standard |
|---|---|---|
gemini-3.8-flash | low / medium / high | medium |
gemini-3.7-flash | low / medium / high | medium |
gemini-3.6-flash | minimal / low / medium / high | medium |
gemini-3.5-flash | minimal / low / medium / high | medium |
gemini-3.5-flash-lite | minimal / low / medium / high | minimal |
gemini-3.1-flash-lite-preview | minimal / low / medium / high | minimal |
gemini-3-flash-preview | minimal / low / medium / high | medium |
gemini-3.1-pro-preview | low / medium / high | high |
gemini-3.1-pro-preview-customtools | low / medium / high | high |
gemini-3-pro-preview | low / medium / high | high |
Das Übergeben einer vom Modell nicht unterstützten Stufe (z. B. minimal an die Pro-Serie oder an gemini-3.8-flash / gemini-3.7-flash) wird automatisch auf low herabgestuft und führt zu keinem Fehler.
minimal, low, medium, high "minimal"
Random seed used to make output as reproducible as possible, corresponding to Gemini's seed.
12345
Response format settings, supporting JSON mode and JSON Schema, corresponding to Gemini's responseMimeType, responseSchema and responseJsonSchema.
- Option 1
- Option 2
Show child attributes
Show child attributes
Streaming response options. Can be set when stream is true.
Show child attributes
Show child attributes
List of tool definitions for Function Calling.
Show child attributes
Show child attributes
Controls tool-calling behavior.
none, auto, required Gemini extension parameters.
Show child attributes
Show child attributes
Antwort
Chat-Vervollständigung erfolgreich generiert
Eindeutiger Bezeichner für die Chat-Vervollständigung
"chatcmpl-20251010015944503180122WJNB8Eid"
Tatsächlich verwendeter Modellname
"gemini-3.6-flash"
Antworttyp
chat.completion "chat.completion"
Erstellungszeitstempel
1760032810
Liste der Chat-Vervollständigungsoptionen
Show child attributes
Show child attributes
Token-Nutzungsstatistiken
Show child attributes
Show child attributes