Przejdź do głównej treści

Wprowadzenie

OpenAI to usługa czatu AI oferowana przez Ace Data Cloud, oparta na dużych modelach językowych serii OpenAI GPT. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywoływać OpenAI za pomocą cURL, realizując funkcje takie jak wieloetapowa rozmowa, systemowe podpowiedzi, strumieniowe wyjście, tryb wyjścia JSON, osadzanie tekstu, generowanie obrazów i inne.

Wymagania wstępne

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

Podstawowe użycie

Główny punkt końcowy API OpenAI to:
POST https://api.acedata.cloud/openai/chat/completions
W tym przykładzie używany jest model gpt-4o. Dostępne modele to: gpt-4o, gpt-4o-mini, o1, o3-mini. Pełny przykład polecenia cURL:
curl -X POST https://api.acedata.cloud/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好,请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}'
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym 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/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好,请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}' | jq .

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieudana autoryzacja, proszę sprawdzić token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit częstotliwości żądań
500Wewnętrzny błąd serwera

Kolejne kroki