DeepSeek API இணைப்பு வழிகாட்டி: ECAIX வழியாக OpenAI-கம்பேட்டIBLE கோட்பாடுகள்

இந்த வழிகாட்டி ECAIX வழியாக ஒரு DeepSeek மாடல் ID ஐ OpenAI-கம்பேட்டIBLE API எண்ட்போயிண்ட் மூலம் சோதிக்கும் முறைகளை விளக்குகிறது. இது சிறிய செயல்முறையின் சிறந்த வேலைக்கூறுகள், Python மற்றும் curl உதவி சோதனைகள், மாடல் ID சான்றிதழ், பகுப்பாய்வு, கட்டமைக்கப்பட்ட பதிவிறக்கம், கருவிகள் மற்றும் பொதுவான தவறுகளின் தீர்வு ஆகியவற்றை உள்ளடக்குகிறது.

இந்த வழிகாட்டி ECAIX கேட்டரகில் உள்ள மாடல் ID ஐ எடுத்துக்கொள்கிறது. இது ECAIX அதிகாரப்பூர்வ DeepSeek API எண்ட்போயிண்ட் அல்லது எந்த DeepSeek அம்சங்களும் எந்த கேட்டரக வழியாகவும் எல்லா நேரத்திலும் கிடைக்கும் என்று உறுதி செய்யாது. புதிய இணைப்பு அல்லது தயாரிப்பில் முன் செல்லும் முன், வாழ்நாள் மாடல் பக்கம் மற்றும் வழங்குநர் ஆவணங்களை சரிபார்க்கவும்.

விரைவான தொடக்கம்

ஒரு OpenAI SDK பயன்பாட்டை நீங்கள் தயாராகக் கொண்டிருந்தால், பின்வரும் செயல்முறையை பின்பற்றவும்:

1. DeepSeek v4.1 Flash மாடல் பக்கத்தை திறந்து, ID ஐ உறுதிப்படுத்தவும்.
2. ECAIX API கீவை உருவாக்கவும்.
3. OpenAI-கம்பேட்டIBLE அடிப்படை URL ஐ https://ecaix.com/api/ai/v1 என அமைக்கவும்.
4. SDK மற்றும் பயன்பாட்டு குறியாக்கத்தை மாற்றுவதற்கான இடங்களில் மாற்றமின்றி வைத்திருக்கவும்.
5. கீழே உள்ள சிறிய கோரிக்கையை செயல்படுத்தவும்.
6. பகுப்பாய்வு, JSON பதிவிறக்கம் அல்லது கருவிகள் போன்ற அம்சங்களை மட்டுமே செயல்படுத்தும் முன், அடிப்படை கோரிக்கை வெற்றிகரமாக செயல்பட வேண்டும்.

எண்ட்போயிண்ட் மற்றும் மாடல் ID

OpenAI-கம்பேட்டIBLE கிளையன்ட்களுக்கு பின்வரும் எண்ட்போயிண்டை பயன்படுத்தவும்:

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

மாடல் ID ஒரு பழைய கட்டுரையில் உறுதிப்படுத்தப்பட்டதை விட ஒரு பழைய கட்டுரையில் உறுதிப்படுத்தப்படாதது. புதிய இணைப்பு அல்லது தயாரிப்புக்கு முன், வாழ்நாள் மாடல் பட்டியல் இல் மாடல் தகவல்களை உறுதிப்படுத்தவும். நீங்கள் வேறு DeepSeek குடும்பத்தை தேடுகிறீர்களா? மாடல் தகவல்களில் உள்ள துல்லியமான ID ஐ மட்டுமே காப்பியம் செய்யவும், சுருக்கம் செய்யாது.

எண்ட்போயிண்ட் வடிவமைப்பும் முக்கியமானது. SDK ஐப் பெறும் அடிப்படை பாதை /v1 முடிவில் இருக்க வேண்டும்; கிளையன்ட் /chat/completions அல்லது மற்றொரு செயல்முறைப் பாதையைச் சேர்க்க வேண்டும். அடிப்படை URL ஐ /chat/completions சேர்க்காதீர்கள், ஏனெனில் SDK அது சேர்க்கிறது.

Python இல் OpenAI SDK

வirtual environment இல் OpenAI Python SDK ஐ நிறுவவும் அல்லது புதுப்பித்து:

python -m pip install --upgrade openai

அடுத்து ECAIX அடிப்படை URL ஐ மற்றும் API கீவை பயன்படுத்தவும்:

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

API கோரிக்கையை செயல்படுத்துவதற்காக சேவையகக் குறியாக்கத்தை பயன்படுத்தவும். ஒரு ப்ரோகிராம்மிங் ப்ரோகிராமில் API கீவை வெளிப்படுத்தாதீர்கள்.

Curl சோதனை கோரிக்கை

SDK சோதனை தோல்வியடைந்தால், SDK ஐ எளிதாக நீக்கி எண்ட்போயிண்ட் நேரடியாக சோதிக்கவும். கோரிக்கை மற்றும் பதிவிறக்க வடிவத்தை பிரித்து, HTTP சிக்கல்களையும் பதிவிறக்க வடிவ சிக்கல்களையும் வேறுபடுத்தவும்.

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

பெப்ட்டு பதிவிறக்கம் அல்லது பதிவிறக்கத்தை ஒரு பொதுவான தீர்வில் வெளியிடாதீர்கள். API கீவி, கோரிக்கை ID, கேள்விகள், ரிபோசிட்டி பாதைகள் மற்றும் காட்சிப்படுத்தும் தரவுகளை நீக்கி.

பதிவிறக்கத்தை சோதிக்கும் முறை

பின்வரும் வரிசையில் செயல்படுத்தவும்:

1. HTTP நிலை: கோரிக்கை ஒரு சரியான எண்ட்போயிண்டை அடையவில்லை என்பதை உறுதிப்படுத்தவும்.
2. பதிவிறக்கம்: வழங்குநர் அல்லது கேட்டரக சிக்கல் எண்ணை படிக்கவும்.
3. மாடல் ID: தற்போதைய மாடல் பட்டியலில் மட்டுமே மாடல் ID ஐ காப்பியம் செய்யவும்.
4. ஆதரவு: கீவி தலைப்பை, கணக்கை மற்றும் அனுமதிகளை சரிபார்க்கவும்.
5. கோரிக்கை வடிவம்: உட்புறம் model, messages மற்றும் ஒரு சிறிய பதிவிறக்க வரம்பை மட்டுமே கொண்ட கோரிக்கையை குறைக்கவும்.
6. அம்சங்கள்: பகுப்பாய்வு, JSON அல்லது கருவிகள் போன்ற அம்சங்களை ஒன்று ஒன்று சேர்த்து செயல்படுத்தவும்.
7. SDK நடத்தை: SDK கோரிக்கையை நேரடி curl கோரிக்கையுடன் ஒப்பிடவும்.

இது ஒரு கிளையன்ட் லைப்ரரி சிக்கலை ஒரு மாடல் வழித்திருப்பு அல்லது கணக்கு அனுமதிகளால் தவறாகப் புரிந்து கொள்ளாததை தடுக்கிறது.

பகுப்பாய்வு பதிவிறக்கங்கள்

ஒரு பயன்பாட்டு தேவைப்பட்டால், பகுப்பாய்வு மட்டுமே வெற்றிகரமான கோரிக்கை வெற்றிகரமாக செயல்படும் முன் மட்டுமே செயல்படுத்தவும்:

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)

எண்ட்போயிண்ட் மற்றும் SDK ஆகியவற்றின் துல்லியமான நிகழ்வுகளைச் சார்ந்திருக்கிறது. ஒரு பழைய டெல்டா, இறுதி பயன்பாட்டு நிகழ்வு, இணைப்பு இடைவெளி மற்றும் [DONE]-படைப்பு போன்றவற்றைச் சோதிக்கும் முன், ஒரு சோதனை செயல்முறையை உங்கள் ப்ரோகிராம்மிங் ப்ரோகிராமில் தயாராகச் செயல்படுத்தாதீர்கள்.

கட்டமைக்கப்பட்ட பதிவிறக்கம் மற்றும் JSON

ஒரு இயற்கை மொழி பதிவிறக்கத்தை தேவைப்படுமானால், ஒரு சாதாரண கோரிக்கையைச் செயல்படுத்தி, பின்னர் எண்ட்போயிண்ட் மற்றும் மாடல் ஆதரவான சிறிய கட்டமைக்கப்பட்ட பதிவிறக்கம் அம்சத்தைச் சேர்க்கவும். ஒரு "JSON ஐ திரும்பப் பெறவும்" என்ற கேள்வி ஒரு சக்தி-பயன்பாட்டு பதிவிறக்கத்தை விட வேறுபட்டது.

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 ஐ ஏற்றுக்கொள்ள முடியும் என்பதை மாடல் மற்றும் பாதை சார்ந்தது. ஒரு ஆதரவற்ற-பரம்பரை சிக்கலைப் பெற்றால், அப்பரம்பரையை நீக்கி பாதை ஆவணத்தைச் சரிபார்த்து, மற்றொரு வடிவத்தை முயற்சிக்கவும்.

கருவி அழைப்புகள் மற்றும் கருவிகள்

கருவி அழைப்புகள் ஒரு கருவி உதவி சோதனையிலிருந்து வேறுபட்டது. ஒரு நல்ல கருவியைச் சோதிக்கவும் மற்றும் திரும்பப் பெறப்பட்ட பெயர் மற்றும் வசதிகளைச் சரிபார்த்து, எதையும் செயல்படுத்துவதற்கு முன்.

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)

மாடல் ஒரு சரியான பதிவிறக்கத்தை திரும்பப் பெறலாம், ஆனால் கருவி அழைப்புகள் மாடல் ஆதரவினால் சிக்கலடைந்து, சக்தி வடிவமைப்பு, ஆதரவற்ற பரம்பரைகள் அல்லது கிளையன்ட்-சார்ந்த நடத்தையால் தோல்வியடையலாம். உங்கள் தயாரிப்பில் சரியான சக்தி வடிவமைப்பு மற்றும் ஆதரவுடன் கருவி வசதிகளைச் செயல்படுத்துவதற்கு முன், சக்தி வடிவமைப்பை சரிபார்த்து மற்றும் ஆதரவளிக்கும் சான்றுகளைச் சேர்க்கவும்.

OpenAI-கம்பேட்டIBLE மற்றும் Anthropic-கம்பேட்டIBLE பாதைகள்

ECAIX பல்வேறு கிளையன்ட்களுக்கு வேறுபட்ட ஒத்தபாடுகளை வெளிப்படுத்துகிறது: