توثيق API

البدء السريع

1. انتقل إلى لوحة تحكم API وأنشئ مفتاحًا. انسخ قيمة cgw-sk-... — فهي تُعرض مرة واحدة.
2. اشحن رصيدك عبر الفوترة. رصيد واحد يغطي استدعاءات API واستئجار GPU.
3. أرسل طلبًا:

cURL
curl https://cloudgpu.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLOUDGPU_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Say hi in one sentence."}
    ]
  }'

المصادقة

كل طلب إلى /v1/* requires an Authorization: Bearer cgw-sk-<your_key> header. Keys are scoped to your CloudGPU account. Revoke any key any time from the console; revocation takes effect immediately.

The raw key is shown exactly once at creation time. We store only a sha256 hash; we cannot recover it if you lose it. Create a new key if that happens.

نقاط النهاية

التضمينات (Embeddings) غير متاحة بعد.

البث

مرّر "stream": true في جسم الطلب. الاستجابة بصيغة Server-Sent Events وفق OpenAI. يتعامل OpenAI SDK مع ذلك تلقائيًا.

Python (streaming)
# Streaming — same client, stream=True
for chunk in client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Count to 5."}],
    stream=True,
):
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

SDKs

لا نوفّر SDK خاصًا بنا — يعمل OpenAI SDK كما هو مع base_url لتجاوز القيمة.

Python
# pip install openai>=1.0
from openai import OpenAI

client = OpenAI(
    api_key="cgw-sk-...",                     # from /api/console
    base_url="https://cloudgpu.app/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Say hi."}],
)
print(resp.choices[0].message.content)
print(f"Used {resp.usage.total_tokens} tokens")

Node.js
// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CLOUDGPU_API_KEY,
  baseURL: "https://cloudgpu.app/v1",
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Say hi." }],
});
console.log(resp.choices[0].message.content);

الأسعار والفوترة

تدفع لكل رمز أو لكل صورة أو لكل حرف أو لكل ثانية صوت، حسب النموذج؛ والسعر الحالي لكل نموذج موجود في جدول الأسعار على https://cloudgpu.app/api. لا يُحتسب أي شيء بالساعة، ولا يوجد حد أدنى شهري.

Each request deducts from your prepaid balance. Successful calls show in your لوحة التحكم within ~1 second with full token counts and dollar cost.

جدول الأسعار الكامل لكل نموذج في الصفحة الرئيسية.

مثيلات GPU

مفتاح API نفسه يتيح أيضًا استئجار GPU: اعرض ما هو متاح، وشغّل مثيلًا من قالب، واستعلم حتى يصبح قيد التشغيل، واقرأ بيانات SSH ونقطة نهاية API العامة، ثم احذفه. الفوترة مطابقة للوحة التحكم على الويب — بالدقيقة، ومن الرصيد نفسه.

يتناول هذا القسم REST API. يمكن لكل حساب استخدامها بمفتاح API نفسه. يعتمد عدد المثيلات التي يمكن لحساب واحد تشغيلها في آنٍ واحد على سجل الشحن: 1 للحسابات التي لم تشحن قط، و3 بعد أول عملية شحن، و10 بعد شحن إجمالي قدره $100.

تستخدم Cursor أو Cline أو opencode أو Claude Code أو مساعد برمجة ذكيًا آخر؟ يغلّف خادم CloudGPU MCP هذه الـ API حتى يتمكن المساعد من استئجار GPU، وتشغيل المهمة، وتنزيل النتائج، ثم إيقافه.

curl -X POST https://cloudgpu.app/v1/gpu/instances \
  -H "Authorization: Bearer $CLOUDGPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gpu_model": "RTX 4090", "template": "ollama",
       "max_minutes": 120, "max_spend_usd": 2, "idle_minutes": 30}'

# 202 Accepted
{"id":"2096…","object":"gpu.instance","gpu_model":"RTX 4090","gpu_count":1,"template":"ollama",
 "status":"creating","ssh":null,"api_url":null,
 "limits":{"max_minutes":120,"max_spend_usd":2,"idle_minutes":30,"expires_at":null,"stopped_by":null}, …}

# poll GET /v1/gpu/instances/{id} until status is "running";
# then ssh.host / ssh.port / ssh.password and api_url (for API templates) are filled in.

حدود أخرى: 20 عملية إنشاء في الساعة و60 طلبًا إلى GPU API في الدقيقة لكل مفتاح. راسل support@cloudgpu.app لرفعها لعبء عمل حقيقي.

حدود المعدّل

توجد هذه القيم الافتراضية لمنع إساءة الاستخدام خلال المرحلة التجريبية العامة. تواصل معنا إذا احتجت إلى رفعها — يسعدنا ذلك لأي عبء عمل حقيقي، نحتاج فقط إلى معرفة حالة الاستخدام.

الأخطاء

تتبع استجابات الأخطاء صيغة OpenAI: رمز حالة HTTP + نص JSON { error: { type, code, message } }.