📚 RAVA Developer Docs

مستندات API

در ساده‌ترین حالت فقط text و apikey را ارسال کن. یک کلید روی تمام مدل‌های فعال معتبر است.

شروع سریع

فرمت عمومی GET:

https://ravaapi.pro/grok43/?text=سلام&apikey=YOUR_API_KEY

می‌توانی API Key را به‌جای Query با هدر X-API-Key هم بفرستی. برای پروژه‌های واقعی، هدر توصیه می‌شود.

ساختار پاسخ

{ "ok": true, "model": "grok43", "response": "متن پاسخ مدل", "usage": { "daily_limit": 100, "remaining": 99 }, "latency_ms": 1234 }
grok_4_3

Grok 4.3

/grok43/

curl -G 'https://ravaapi.pro/grok43/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
grok_3_mini

Grok 3 Mini

/grok3mini/

curl -G 'https://ravaapi.pro/grok3mini/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_5_2

GPT-5.2

/gpt52/

curl -G 'https://ravaapi.pro/gpt52/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_5

GPT-5

/gpt5/

curl -G 'https://ravaapi.pro/gpt5/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_5_mini

GPT-5 Mini

/gpt5mini/

curl -G 'https://ravaapi.pro/gpt5mini/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_5_nano

GPT-5 Nano

/gpt5nano/

curl -G 'https://ravaapi.pro/gpt5nano/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_4o

GPT-4o

/gpt4o/

curl -G 'https://ravaapi.pro/gpt4o/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_4o_mini

GPT-4o Mini

/gpt4omini/

curl -G 'https://ravaapi.pro/gpt4omini/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gpt_5_6_luna

GPT-5.6 Luna

/gpt56luna/

curl -G 'https://ravaapi.pro/gpt56luna/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gemini_3_flash

Gemini 3 Flash

/gemini3flash/

curl -G 'https://ravaapi.pro/gemini3flash/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
gemini_lite

Gemini Lite

/geminilite/

curl -G 'https://ravaapi.pro/geminilite/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
claude_haiku_4_5

Claude Haiku 4.5

/claudehaiku45/

curl -G 'https://ravaapi.pro/claudehaiku45/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
deepseek_v3

DeepSeek V3

/deepseekv3/

curl -G 'https://ravaapi.pro/deepseekv3/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'
deepseek_r1

DeepSeek R1

/deepseekr1/

curl -G 'https://ravaapi.pro/deepseekr1/' --data-urlencode 'text=سلام' --data-urlencode 'apikey=YOUR_API_KEY'

POST JSON

برای متن‌های بلندتر می‌توانی JSON بفرستی:

POST https://ravaapi.pro/gpt5/ Content-Type: application/json X-API-Key: YOUR_API_KEY { "text": "سلام، یک پاسخ کامل بده" }

کدهای خطا

  • 401 missing_apikey — کلید ارسال نشده
  • 401 invalid_apikey — کلید نامعتبر یا حساب غیرفعال
  • 429 rate_limit — سقف دقیقه‌ای پر شده
  • 429 daily_limit — سهمیه روزانه تمام شده
  • 502 provider_error — سرویس مدل بالادستی پاسخ موفق نداده