---
title: "RunAPI CLI — شغّل 210+ نموذج ذكاء اصطناعي من الطرفية"
url: "https://runapi.ai/ar/cli.md"
canonical: "https://runapi.ai/ar/cli"
locale: "ar"
---

# RunAPI CLI

أداة واحدة تستدعي 210+ نموذج ذكاء اصطناعي — Suno وVeo وKling وFlux وClaude وGPT وغيرها — مع إخراج JSON أولًا ينسجم بسلاسة مع السكربتات وخطوط CI وبيئات تشغيل الوكلاء.

## Install

**curl (Linux / macOS):**

```bash
curl -fsSL https://runapi.ai/cli/install.sh | sh
```

**Homebrew:**

```bash
brew install runapi-ai/tap/runapi
```

**Go source build (Go 1.22+):**

```bash
go install github.com/runapi-ai/cli/cmd/runapi@latest
```

## Quickstart

```bash
# Authenticate
runapi login

# Generate an image
runapi nano-banana generate \
  --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# Generate music (async)
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate
```

## What Is RunAPI CLI?

RunAPI CLI أداة Go ثنائية واحدة تستدعي 210+ نموذج ذكاء اصطناعي من 23 مزودًا عبر API موحّدة. بدلًا من تثبيت SDK منفصل لكل من Suno وKling وFlux وClaude وGPT، تُشغّل أمرًا واحدًا — runapi <service> <action> — وتحصل على JSON منظّم. تتولى الأداة المصادقة والاستعلام غير المتزامن وتنسيق الإخراج حتى تبقى سكربتات shell وخطوط CI وبيئات الوكلاء لديك نظيفة. كل طلب يُفوتر بالاستدعاء دون حد أدنى شهري، وتحفظ الأداة مفتاح API محليًا فتُصادق مرة واحدة وتُشغّل الأوامر من أي مجلد.

## Features

- **JSON-first output** — Every command returns structured JSON for scripts and pipelines.
- **Async + polling** — `--async` flag to fire-and-forget, `runapi wait` to poll.
- **Agent runtime** — Install skills into Claude Code, Codex, Gemini CLI with `runapi agent install-skill`.

## What Can You Generate?

- **توليد الصور** — Flux وNano Banana وRecraft وIdeogram وSeedream وGPT Image وImagen 4 — أنشئ الصور وحرّرها من نصوص توجيهية.
- **توليد الفيديو** — Kling وVeo وRunway وLuma وHailuo وWan وSeedance — توليد فيديو من النص مع استعلام غير متزامن مدمج.
- **الموسيقى والصوت** — Suno للموسيقى، وElevenLabs لتحويل النص إلى كلام واستنساخ الأصوات، وInfiniteTalk للأفاتارات الناطقة.
- **دردشة LLM والإكمال** — Claude وGPT وGemini وDeepSeek وGrok وQwen — إكمالات دردشة بالبث عبر endpoint متوافق مع OpenAI.

## FAQ

### كيف أثبّت RunAPI CLI؟

ثلاث طرق: curl -fsSL https://runapi.ai/cli/install.sh | sh (يكتشف نظام التشغيل والمعمارية تلقائيًا)، أو brew install runapi-ai/tap/runapi (Homebrew)، أو go install github.com/runapi-ai/cli/cmd/runapi@latest (بناء من مصدر Go).

### ما المنصات التي يدعمها سكربت التثبيت عبر curl؟

macOS وLinux على معماريتي amd64 وarm64. يكتشف سكربت التثبيت عبر curl نظام التشغيل والمعالج تلقائيًا، ويتحقق من SHA-256 checksum، ويكتب الملف الثنائي إلى /usr/local/bin.

### هل يمكنني استخدام CLI في خطوط CI؟

نعم. استخدم مثبت curl في خط CI/CD واضبط RUNAPI_API_KEY كمتغير بيئة. يدعم CLI المصادقة headless عبر runapi auth import-token للبيئات غير التفاعلية.

### ما نماذج الذكاء الاصطناعي التي يمكنني تشغيلها من CLI؟

210+ نموذجًا عبر 23 مزودًا: Suno للموسيقى، وKling وVeo للفيديو، وFlux وNano Banana للصور، وElevenLabs للصوت، وClaude وGPT وGemini وDeepSeek لنماذج LLM.

### كيف يعمل التعامل مع المهام غير المتزامنة؟

استخدم --async للتشغيل بدون انتظار. سيعيد CLI معرّف المهمة فورًا. ثم استخدم runapi wait TASK_ID للاستعلام حتى الاكتمال. يجعل إخراج JSON استخراج معرّفات المهام باستخدام jq أمرًا سهلًا.

### كم تكلّف RunAPI CLI؟

أداة CLI نفسها مجانية ومفتوحة المصدر. تدفع فقط مقابل استدعاءات API على أساس طلب بطلب دون حد أدنى شهري. يبدأ توليد الصور من $0.02 لكل صورة، وتوليد الفيديو من $0.10 للمقطع، وتُفوتر استدعاءات LLM لكل token بما يقارب 50% أقل من الأسعار الرسمية للمزودين.

### هل تعمل CLI مع بيئات تشغيل الوكلاء مثل Claude Code؟

نعم. تنشر RunAPI مهارات نماذج قابلة للتثبيت لـ Claude Code وCodex وGemini CLI وغيرها من بيئات الوكلاء المتوافقة مع MCP. شغّل runapi skill install لإضافة مهارة نموذج؛ يمكن للوكيل بعدها استدعاء نماذج RunAPI كأدوات أصيلة دون الحاجة إلى تهيئة API يدوية.


## Links

- [Model catalog](https://runapi.ai/ar/models)
- [MCP Server](https://runapi.ai/ar/mcp)
- [SDKs](https://runapi.ai/ar/sdk)
- [Skills](https://runapi.ai/ar/skills)
- [Pricing](https://runapi.ai/ar/pricing)
- [API docs](https://runapi.ai/ar/docs)
- [GitHub](https://github.com/runapi-ai/cli)