DeepSeek API-integraatioopas: OpenAI-muotoiset pyynnöt ECAIX:n kautta

Tämä opas kertoo, miten testata DeepSeek-mallin ID:tä ECAIX:n kautta OpenAI-muotoisen API-päätteen avulla. Se käsittelee pienimmän toimivaa pyynnöstä, Python- ja curl-esimerkkejä, mallin-ID-tarkistusta, virtausta, rakennevastetta, työkaluja ja virheiden diagnosointipäätettä.

Opas kuvaa ECAIX-vesiputken pääsyä mallin ID:ään, joka esitellään nykyisessä ECAIX-katalogissa. Se ei ole väitöksiä siitä, että ECAIX on virallinen DeepSeek-API-päätteen tai että kaikki DeepSeek-ominaisuudet ovat käytettävissä kaikissa vesiputkissa. Tarkista aina live-mallipäivityksen ja tarjoajan dokumentaatio ennen tuotantotyön siirtämistä.

Alkuperäinen aloitus

Käytä tätä sekvenssia, jos olet jo saanut OpenAI SDK:n sovellus:

1. Avaa DeepSeek v4.1 Flash mallipäivityksen sivu ja varmista, että ID on saatavilla.
2. Luo ECAIX API-avaimen.
3. Muuta OpenAI-muotoisen perusURL:n osoiteksi https://ecaix.com/api/ai/v1.
4. Jätä SDK ja sovelluskoodi mahdollisimman muuttumattomana.
5. Suorita alla oleva pienin pyyntö.
6. Lisää virtausta, JSON-vastetta tai työkaluja vasta kun peruspyyntö toimii.

Päätteen ja mallin ID

OpenAI-muotoisille klienteille käytä seuraavaa:

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

Mallin ID ei ole blogin artikkelin pysyvä lupaus. Varmista se aina live-mallin suorassa katalogissa ennen uutta integrointia tai tuotantotilaa. Jos tarvitset eri DeepSeek-sukupolven mallin, kopioi tarkka ID mallin yksityiskohdan sivulta, ei arvata lisäosia.

Päätteen muoto on tärkeä. SDK pitäisi saada perusreitti päättyen /v1; klientti lisää /chat/completions tai toisen toimintareitin. Älä lisää /chat/completions perusURL:iin, jos SDK lisää sen itse.

Python OpenAI SDK:n kanssa

Lataa tai päivitä OpenAI Python SDK virtuaalympyrässä:

python -m pip install --upgrade openai

Käytä ECAIX:n perusURL ja API-avaimen:

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);

Käytä palvelinpuolista koodia API-pyynnön suorittamiseen. Selaimessa oleva sovellus pitää kutsua omaa backendia, ei esitä ECAIX-avainta sivupuolella olevaan JavaScriptiin.

Curl-diagnostinen pyyntö

Jos SDK epäonnistuu, poista SDK:n ulkopuolelta ja testaa päätettä suoraan. Säästää päätteen ja ruohonleikkurin erillään niin, että voit erottaa HTTP-ongelman vastausmuodon ongelmasta.

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
  }'

Älä kopioi säästettyjä päätteen tai vastaus sisältöä julkiseen tilaan ilman API-avainten, pyynnön ID:tä, promptteja, repositorion tietoja ja asiakastietoja.

Vastauksen diagnosointi

Käytä seuraavaa järjestystä:

1. HTTP-tila: selvitä, onko pyyntö saavuttanut päätteen.
2. Vastausruoho: lukee tarjoajan tai vesiputken virhekoodin.
3. Mallin ID: kopioi tarkka ID nykyisestä mallin katalogista.
4. Vahvistus: tarkista avainpäätteen, tilin ja oikeudet.
5. Pyynnön muoto: vähennä ruohoa model, messages ja pienellä tulostusrajoituksella.
6. Ominaisuudet: lisää virtausta, JSONia tai työkaluja yksi kerrallaan.
7. SDK:n käyttäytyminen: verrata SDK:n pyynnön ja suoraan curl-pyynnön.

Tämä estää klienttilibraarin ongelman sekoittumasta mallin reitistöön tai tilan oikeuksien ongelmista.

Virtaava vastaus

Jos sovellus tarvitsee incrementaalista tulosta, lisää virtausta vasta kun normaalipyyntö onnistuu:

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)

Tarkkaa tapahtumien käyttäytymistä riippuu päätteen ja SDK:n mukaan. Varmista, että kehitysrammun käsittelee tyhjä delta, lopullinen käyttötila, yhteys katkeaminen ja [DONE]-tyylinen lopetus. Älä kutsu virtausratkaisua tuotantokäyttöön, kunnes olet testannut katkeamisia ja uusintapyyntöjä.

Rakenteellinen vastaus ja JSON

Jos tarvitset koneenlukua tulostusta, aloita tavallisella pyynnöllä ja lisää sitten pienin rakennevastetta tuettuja vaihtoehtoja päätteen ja mallin mukaan. Validoi palautetun sisällön todella JSON-parsilla. Vastaus, joka sanoo "palauta JSON", ei ole sama kuin schema-vahvistettu vastaus.

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"])

response_format-kentän hyväksyminen voi riippua mallista ja reitistä. Jos päätteen palauttaa epätyypillinen-parametrivirhe, poista kenttä ja tarkista reitin dokumentaatio ennen yrittämistä uudella muunnoksella.

Työkalukutsut ja työkalut

Työkalukutsut vaativat erillisen testin tekstituotannosta. Aloita yhdellä vaarattomalla funktiolla ja tarkasta palautetut nimen ja argumenttien ennen mitään suoritusta.

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)

Malli voi palauttaa pätevästi tekstivastauksen, mutta työkalukutsut epäonnistua, koska schema-konversio, epätyypilliset parametrit tai klientin spesifinen käyttäytyminen. Älä suorita palautettujen työkalujen argumentteja tuotantojärjestelmään ennen mallin tarkistusta ja lisäämistä oikeusvalvontaan.

OpenAI- ja Anthropic-tukiin yhteensopivat päät

ECAIX tarjoaa eri asiakkaiden ja työntekijöiden eri yhteensopivuuspintojen:

Lue Chat Completions-dokumentaatio, Vastaukset-dokumentaatio ja Anthropic Viestit-dokumentaatio ennen valinnan tekemistä. Samalla mallin ID:llä ei välttämättä ole kaikkien yhteensopivuuspintojen identtisiä kenttiä tai käyttäytymistä.

Nykyiset mallin tiedot

Varmista kyvyt ja saatavuus käyttämällä elävää tietopohjaa:

• DeepSeek v4.1 Flash
• DeepSeek v4 Pro 202606
• Qwen 3.8 Flash

- [GLM 5.3](/models/glm/glm-5.3)

Nämä sivut ovat luotettavampia kuin statinen artikkeli nykyisten mallin ID:tä, kontekstin ja hinta-asioita koskevia linkkejä.

Yleisimmät virheet

Turvallisuus ja tuotantotarkastus

Ennen kuin siirryt testiprojektiin, varmista:

• API-avainit varastoidaan palvelimella ja niitä voi vaihtaa.
• Viestit ja vastaukset eivät sisällä hyväksyttyjä salaisia tai asiakastietoja.
• Ymmärrät, että gateways logoi pyynnöt ja miten pitkään logit säilytetään.
• Mallin saatavuus ja hinnat tarkistetaan elävistä sivuilta.
• Timeoutit, uudelleenlataukset, idempotenssi ja nopeusrajoitukset käsitellään sovellusasiassa.
• Virittely katkeaa ei luo uusia tehtäviä.
• Työkalut sisältävät valikoitukset, validoinnin, oikeudenmukaisuuden ja audittologit.
• Tuottajan ja gatewaysin säännöt sallivat työn, jonka suunnittelet lähettävän.

Vahvista integraatio ennen julkaisua

Kirjoita päivämäärä, asiakasversio, mallin ID, päätepiste, HTTP-tila ja todelliset testit, jotka suoritit. Jos testi ei ole suoritettu, merkkaa se epävarmana. Tämä tallentaa seuraavan mallin tai gatewaysin päivityksen helpottamiseksi ja estää vanhan blogitekstin muuttumasta epätuettuun tuotantotietoon.

Vastaanottotiedot

Onko tämä virallinen DeepSeek API-päätepiste?

Ei. Tämä artikkeli dokumentoi ECAIX-gatewayin pääsyä mallin ID:ään, joka esitellään ECAIX-katalogissa. Käytä virallista DeepSeek API-dokumentaatioita DeepSeekin omalle päätepisteelle, tilasääntöille ja tuottajan omille ominaisuuksille.

Voinko käyttää OpenAI SDK:tä ilman, että muokkaan sovellusta?

Monet OpenAI SDK -sovellukset voivat alkaa muuttamalla perusURL:tä, API-avainta ja mallin ID:tä. Sinun on kuitenkin testattava kentän tukea, virittelyä, työkalujen toimintaa, vastausmuotoja, virheiden käsittelyä ja minkä tahansa sovelluksesi käyttämien tuottajan ominaisuuksien toimivuutta.

Minkä DeepSeek-mallin tulisin käyttää?

Aluksi valitse mallin luettelo ja valitse tehtävän mukaan: ohjelmointi, päätelmien tekeminen, kontekstin pituus, monimuotoinen input tai kustannukset. Älä valitse vain vanhan artikkelin kopioitua nimeä. Varmista nykyinen mallin ID ja testaa se omilla viesteillasi.

Voinko käyttää tätä Claude Code -työkalua?

Anthropic-tukiin yhteensopivan päätteen voi testata kolmannen osapuolen tuottajana, mutta Anthropic ei tue reitistä Claude Code -mallia ei-Claude-malleille gateways kautta. Älä esitä tätä virallisena Anthropicin tuena tai täydellisen Claude Code -yhteensopivuuden takuuna.

Missä tarkistetaan nykyiset hinnat ja rajoitukset?

Käytä ECAIX-hinta-asiakirjaa, mallin luetteloa ja tilasi hallintaa. Älä kiinnitä kiinni tämän artikkelin sisältämästä hinnasta sovellukseesi.