Przejdź do głównej treści

​
Wprowadzenie

Gemini to usługa czatu AI oferowana przez Ace Data Cloud, wykorzystująca serię dużych modeli językowych Google Gemini. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywoływać Gemini za pomocą cURL, realizując funkcje takie jak wieloetapowa rozmowa, systemowe podpowiedzi, strumieniowe wyjście czy tryb wyjścia JSON.

​
Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokenu API
  • Środowisko terminalowe z zainstalowanym cURL

​
Podstawowe użycie

Główny endpoint API Gemini to: 
POST https://api.acedata.cloud/gemini/chat/completions
W tym przykładzie używany jest model gemini-2.5-flash. Dostępne modele to: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-3.0-pro. Pełny przykład polecenia cURL: 
curl -X POST https://api.acedata.cloud/gemini/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}'
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia: 
curl -s -X POST https://api.acedata.cloud/gemini/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-2.5-flash", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}' | jq .

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

​
Kolejne kroki