Povezava sa API-jem DeepSeek: Postavljanje zahtevova u skladu s OpenAI-jem kroz ECAIX

Ovaj vodič prikazuje kako testirati model ID DeepSeek kroz ECAIX koristeći OpenAI-kompatibilni API. Obuhvata najmanju radnu kombinaciju zahtevova, primjerove u Pythonu i curl-u, provjeru model ID-a, streaming, strukturovanu izlaznu podatu, alatke, i dijagnostičku putanju za najčešće greške.

Vodič opisuje priступ ECAIX-ovom vratniku za model ID koji je izložen u trenutnom katalogu ECAIX-a. Ne tvrdi da je ECAIX službeni endpoint za API DeepSeek ili da svaki model DeepSeek dostupan je kroz svaki vratnik. Provjerite živog modela na stranici i dokumentaciju dostavljača prije transfera radnog opterećenja u proizvodnu sredinu.

Brzi početak

Koristite ovaj postupak ako već imate aplikaciju s OpenAI SDK:

1. Otvorite stranicu DeepSeek v4.1 Flash modela i potvrđite da je ID dostupan.
2. Stvorite ECAIX API ključ.
3. Postavite OpenAI-kompatibilnu osnovnu URL na https://ecaix.com/api/ai/v1.
4. Zadržite SDK i aplikacijski kod što je moguće nepromijenjen.
5. Izvršite minimalni zahtev ispod.
6. Dodajte streaming, JSON izlaz ili alatke tek nakon što je osnovni zahtev uspješno funkcionirao.

Endpoint i model ID

Za OpenAI-kompatibilne kliente koristite:

Base URL: https://ecaix.com/api/ai/v1
Model:    deepseek-v4.1-flash

Model ID nije trajni obaveznica u blogu. Potvrdite ga na živoj stranici s modelima prije svakog novog integriranja ili izdavanja. Ako trebate različit član DeepSeek familije, kopirajte točnu ID iz detalja modela umjesto da gajete sufix.

Važnost formata endpointa također je važna. SDK treba dobiti osnovnu putanju koja završava na /v1; klient dodaje /chat/completions ili drugu operacijsku putanju. Ne dodajte /chat/completions na base_url ako SDK već dodaje to.

Python s OpenAI SDK

Instalirajte ili ažurirajte OpenAI Python SDK u virtualnom okruženju:

python -m pip install --upgrade openai

Zatim koristite osnovnu URL ECAIX-a i API ključ:

const client = new OpenAI({
  apiKey: process.env.ECAIX_API_KEY,
  baseURL: "https://ecaix.com/api/ai/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [
    { role: "user", content: "Return one short sentence about API testing." },
  ],
  max_tokens: 128,
});

console.log(response.choices[0].message.content);

Koristite server-stranu kod za izvršavanje API zahtevova. Frontend aplikacija treba pozivati svoj vlastiti backend umjesto izlaganja ECAIX ključa u kodu za stranicu.

Curl dijagnostički zahtev

Ako SDK ne radi, uklonite SDK iz razmatranja i testirajte endpoint direktno. Zadržite headers i tijelo zahtevova razdvojena tako da možete razlikovati greške HTTP tipa od problema s formatom odgovora.

curl -sS -D /tmp/ecaix-deepseek-headers.txt \
  -o /tmp/ecaix-deepseek-response.json \
  -w '\nHTTP %{http_code}\n' \
  "https://ecaix.com/api/ai/v1/chat/completions" \
  -H "Authorization: Bearer ${ECAIX_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ],
    "max_tokens": 128
  }'

Ne kopirajte zadržane headers ili odgovore u javno pitanje bez uklanjanja API ključeva, ID zahtevova, pitanja, putanja u repositoryju i podataka klienta.

Diagnostika odgovora

Koristite sljedeći redoslijed:

1. HTTP status: utvrdite je li zahtev stignuo na valjan endpoint.
2. Tijelo odgovora: pročitajte grešku kodova dostavljača ili vratnika.
3. Model ID: kopirajte točnu ID iz trenutne direktorije modela.
4. Autentifikacija: provjerite header ključa, račun i dozvole.
5. Obrazac zahtevova: smanjite tijelo na model, messages i malu granicu za izlaz.
6. Polja funkcija: dodajte streaming, JSON ili alatke po jedan po jedan.
7. Ponašanje SDK-a: usporedite zahtev SDK-a s direktnim curl zahtevom.

Ovaj postupak sprečava greške u biblioteci klienta da se pomešaju s rutiranjem modela ili dozvolama računa.

Odgovori sa streamingom

Ako je vaša aplikacija potrebno incrmentalni izlaz, dodajte streaming tek nakon uspješnog zahtevovanja:

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Summarize API retries in three points."}],
    stream=True,
    max_tokens=256,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Tačan ponašanje događaja ovisi o endpointu i SDK-u. Provjerite kako vaš okruženje obrađuje prazni delta, zadnji događaj upotrebe, prekid vezne linije i završni terminacijski događaj tipa [DONE]. Ne smijete pozivati implementaciju streaminga kao proizvodno spreman do provjere prekida i ponovljenih pokušaja.

Strukturovan izlaz i JSON

Ako trebate mašinski čitljivi izlaz, počnite s običnim zahtevom i zatim dodajte najmanju opciju za strukturovan izlaz podržanu od strane endpointa i modela. Potvrdite povratni sadržaj s realnim JSON parserom. Prompt koji kaže "vratite JSON" nije isti kao schema-izvedena odgovor.

import json

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[
        {
            "role": "user",
            "content": "Return a JSON object with keys title and priority."
        }
    ],
    response_format={"type": "json_object"},
    max_tokens=128,
)

payload = json.loads(response.choices[0].message.content)
print(payload["title"])

Da li response_format je prihvaćen može ovisiti o modelu i putanji. Ako endpoint vrati grešku "nepodržani parametar", uklonite polje i provjerite dokumentaciju putanje prije pokušaja s drugim formatom.

Poziv funkcija i alatke

Poziv alatki zahtijeva osobitu testiranju od tekstnog generiranja. Počnite s jednim neškodnim funkcijom i ispitujte povratne ime i argumenti prije izvršavanja bilo čega.

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_demo_status",
            "description": "Return a fixed status for a local compatibility test.",
            "parameters": {
                "type": "object",
                "properties": {},
                "additionalProperties": False,
            },
        },
    }
]

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Check the demo status."}],
    tools=tools,
    tool_choice="auto",
    max_tokens=128,
)

print(response.choices[0].message.tool_calls)

Model može vratiti valjan tekstni odgovor dok poziv alatki ne radi zbog konverzije schema, nepodržanih parametara ili ponašanja klienta. Nikada ne izvršavajte povratne argumenti alatki u proizvodnoj sredini prije potvrde schema i dodavanja autorizacijskih provjera.

Kompatibilni putovi za OpenAI i Anthropic

ECAIX nudi različite površine kompatibilnosti za različite kliente:

| Klient Anthropic-stilnog tipa | /api/ai/v1/anthropic | Polja poruka, headers, blokovi sadržaja |

| Radni proces za Claude Code trećih stranica | /api/ai/v1/anthropic | Ponašanje specifično za provider; ne je to službena podrška Anthropica |

Prijavi se na dokumentaciju o Chat Completions, dokumentaciju o Odzivima, i dokumentaciju o Anthropic porukama prije izbora putanje. Isti ID modela ne mora prikazivati identična polja ili ponašanja na svakoj površini kompatibilnosti.

Detalji trenutnih modela

Upotrijebite live stranice za provjeru kapaciteta i dostupnosti:

• DeepSeek v4.1 Flash

• DeepSeek v4 Pro 202606

• Qwen 3.8 Flash

• GLM 5.3

Ove stranice su pouzdanije od statične članke za trenutne ID modela, informacije o kontekstu i poveznice za cijene.

Česti greške

Checklista za sigurnost i proizvodnju

Pre nego što se preseli iz testnog projekta, potvrdi:

• API ključevi su pohranjeni na serveru i mogu se rotirati.
• Promptovi i odgovori ne sadrže neautorizirane tajne ili podatke klienta.
• Razumiješ li da li je mostek logirao zahteve i koliko dugo se logovi čuvaju.
• Dostupnost modela i cijene je provjerena na live stranicama.
• Timeoutovi, ponavljanja, idempotencija i granice brzina su obrađeni u vašem aplikaciji.
• Disconnectovi streaminga ne stvaraju duplikate zadataka.
• Pozivi alataka imaju popise dozvoljenih, validacije, autorizacije i logova auditiranja.
• Pojednostavni uslovi i mostek dozvoljavaju rad koji planirate poslati.

Zapisi integraciju prije izdavanja

Napisi datum, verziju klienta, ID modela, krajnicu, HTTP status i testove za funkcije koje je stvarno izvršio. Ako je neko testiranje nije obavljeno, označi ga kao neprovjereno. Ovaj zapis olakšava usporedbu s novim modelom ili mostekom i sprečava da stari blog primjer postane nepodržana pretpostavka za proizvodnju.

Često postavljeni pitanja

Je li to službeni endpoint za API DeepSeek?

Nije. Ova članka dokumentira pristup mosteka ECAIX za model ID koji je prikazan u katalogu ECAIX-a. Koristi službenu dokumentaciju za API DeepSeek za DeepSeekov rodni endpoint, pravila računa i specifične kapabilitete za provider.

Mogam li koristiti OpenAI SDK bez prepisivanja aplikacije?

Većina aplikacija OpenAI SDK-a može započeti promjenom baza URL-a, API ključa i ID modela. Vrijedi još uvijek provjeriti podršku polja, streaming, pozive alataka, formate odgovora, obradu grešaka i bilo kakve specifične za provider funkcije koje koristi vaša aplikacija.

Koji je DeepSeek model koji bi trebao koristiti?

Počni s katalogom modela i izaberi po zadatku: kodiranje, razmišljanje, dužinu konteksta, multimodalni ulaz ili troškove. Ne izaberi samo po nazivu kopiranom iz stare članke. Provjeri trenutni ID modela i testiraj ga protiv svojih promptova.

Mogam li koristiti to sa Claude Code?

Putanja kompatibilna s Anthropicom može se testirati kao treća strana radni proces, ali Anthropic ne podržava rutevanje Claude Code za ne- Claude modele kroz mostek. Ne predstavljaj to kao službenu podršku Anthropica ili garant za potpunu kompatibilnost s Claude Code.

Gde mogu provjeriti trenutne cijene i granice?

Koristi ECAIX stranicu za cijene, katalog modela i kontrolu računa. Ne hard-kodiraj cijenu iz ove članke u aplikaciju.