איך להתקשר לאפיקי DeepSeek באמצעות ECAIX: בקשות פתוחות לאפיקי OpenAI

מדריך זה מציג כיצד לבדוק מודל ID של DeepSeek באמצעות סוף נקודה פתוח לאפיקי OpenAI דרך ECAIX. הוא מכיל בקשה מינימלית עובדת, דוגמאות לפייטון ו-curl, בדיקת ID של מודל, הזרמת תוצאות, יצירת תוצאות מובנות, כלים, ודרך אבחון שגיאות נפוצות.

המדריך מתאר התקשרות דרך גשר ECAIX למודל ID הנשלח בקטלוג הנוכחי של ECAIX. לא נטען כי ECAIX הוא סוף נקודה רשמית של DeepSeek או כי כל תכונות DeepSeek זמינות דרך כל סוף נקודה של הגשר. בדוק את העמוד המודל הנוכחי והדוקומנטציה של provider לפני העברת עבודה ליצור.

התחלה מהירה

השתמש בשלב הבא אם כבר יש לך יישום של SDK של OpenAI:

1. פתח את עמוד המודל DeepSeek v4.1 Flash ו確ם כי ה-ID זמין.
2. יצר מילוי API של ECAIX.
3. קבע את סוף הנקודה הפתוח לאפיקי OpenAI ל- https://ecaix.com/api/ai/v1.
4. שמור את הקוד של ה-SDK והאפליקציה ללא שינויים ככל האפשר.
5. Execute את הבקשה המינימלית מתחת.
6. הוסף הזרמת תוצאות, יצירת JSON או כלים רק לאחר שהבקשה הבסיסית עובדת.

סוף נקודה ו-ID של מודל

ללקוחות פתוח לאפיקי OpenAI, השתמש ב:

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

השם של ה-ID אינו הבטחה קבועה בכתוביות. בדוק אותו בעמוד המודל הנוכחי להלן לפני כל אינטגרציה או שחרור חדשים. אם צריך מודל אחר ממשפחת DeepSeek, קח את ה-ID המדויק מהעמוד הפרטי של המודל ולא תנסה להסיק את הסיומת.

הסדר של הסוף הנקודה גם חשוב. ה-SDK צריך לקבל את הפתח הסופי הסופי /v1; הלקוח מוסיף /chat/completions או מסלול אחר. אל תוסיף /chat/completions לסוף הנקודה כאשר ה-SDK כבר מוסיף אותו.

פייטון עם SDK של OpenAI

הורד או עדכן את SDK הפייטון של OpenAI באמבנטה שלך:

python -m pip install --upgrade openai

אז השתמש בסוף הנקודה של ECAIX ומספר 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 של ECAIX בקוד של JavaScript צד קדמי.

בקשה דיאגנוסטית עם 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, מספר בקשה, פרטים, דרכי קוד, נתונים לקוחות.

איך לבחון את התגובה

השתמש בסדר הבא:

1. סטטוס HTTP: בדוק אם הבקשה הגיעה לסוף נקודה תקין.
2. תגובה גוף: קרא את הקוד של שגיאה של ה-provider או הגשר.
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)

התנהגות האירועים המדויקים תלויה בסוף הנקודה והספרייה. בדוק כיצד תוכנתך מתנהלת עם דלתה ריקה, אירוע שימוש סופי, הפסקת קשר וטיפול בסיום סגנון [DONE].

יצירת תוצאות מובנות ו-JSON

אם צריך תוצאות מובנות, החל עם בקשה רגילה ואז הוסף את האפשרות הקטנה ביותר של יצירת תוצאות מובנות נתמכת על ידי הסוף הנקודה והמודל. בדוק את תוכן התגובה עם פרסן 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 ואנthropic

ECAIX מציג פני תצוגה שונות פתוחות לאפיקי שונים עבור לקוחות שונים:

קרא את תיעוד Completions של Chat, תיעוד תגובות, ותיעוד Messages של Anthropic לפני בחירת מסלול. אותו ID של מודל לא יוצג שדות או התנהגויות זהים בכל פני תצוגה פתוח לאפיקי.

פרטים על מודל נוכחיים

השתמש בעמודי הפרטיים הנוכחיים לבדיקת יכולות וזמינות:

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

עמודי אלה אמורים להיות אמינים יותר מאמר סטטי עבור ID של מודל נוכחיים, מידע על kontext, וישנים על מחירים.

שגיאות נפוצות