RAVA Developer Docs
مستندات وبسرویسها
یک کلید وبسرویس روی همه سرویسهای فعال RAVA معتبر است؛ از هوش مصنوعی تا قیمت ارز و بازار.
۳ مرحله
شروع سریع امن
۱کلید وبسرویس را از ربات بگیر.
۲وبسرویس و Endpoint موردنظر را انتخاب کن.
۳کلید را با هدر
X-API-Key ارسال کن.curl -G 'https://ravaapi.pro/claudehaiku45/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
قرار دادن کلید در URL بهدلیل ثبتشدن در History و Access Log توصیه نمیشود.
سهمیهبندی دستهای
مدلهای هوش مصنوعی یک سهمیه روزانه مستقل دارند. هر دسته غیرهوش نیز سهمیه مستقل و بزرگتر خودش را دارد؛ برای مثال مصرف «قیمت و بازار» از سهمیه هوش مصنوعی یا دستههای دیگر کم نمیشود.
X-RateLimit-Bucket— دستهای که درخواست از سهمیه آن کم شده است.X-RateLimit-Daily-Limit— سقف روزانه همان دسته.X-RateLimit-Daily-Remaining— باقیمانده همان دسته.GET /api/me.phpبا هدرX-API-Key— مصرف AI و همه دستهها را جداگانه برمیگرداند.
قیمت و بازار
قیمت ارز جامع
ارزهای فیات، رمزارز، طلا و سکه، لیست نمادها و تبدیل جفتارز با همان کلید RAVA.
/prices/v1/Endpointها
GET /prices/v1/symbols— لیست همه نمادهاGET /prices/v1/currencies— همه ارزهاGET /prices/v1/currencies/usd— یک ارز مشخصGET /prices/v1/currencies?symbols=usd,eur,aed— چند ارز انتخابیGET /prices/v1/cryptoو/prices/v1/crypto/btc— رمزارزهاGET /prices/v1/goldو/prices/v1/gold/gold_18k— طلا و سکهGET /prices/v1/exchange/eur/usd?amount=100— تبدیل جفتارزGET /prices/v1/all— همه بازارها در یک پاسخ
curl 'https://ravaapi.pro/prices/v1/currencies/usd' -H 'X-API-Key: YOUR_API_KEY'
<?php
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$json = file_get_contents('https://ravaapi.pro/prices/v1/currencies/usd', false, $context);
$data = json_decode($json, true);
print_r($data['result']);
const res = await fetch('https://ravaapi.pro/prices/v1/currencies/usd', {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.result);
import requests
r = requests.get('https://ravaapi.pro/prices/v1/currencies/usd', headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['result'])
فیلدهای خروجی
- ارزها:
symbol،name_fa،buy_toman،sell_toman،usd_cross_rate - رمزارز:
symbol،name،price_toman،change_toman_percent،price_usd،change_usd_percent - طلا و سکه:
symbol،name_fa،currency،price،change_percent،real_price،bubble،bubble_percent - تبدیل ارز:
from،to،rate،amount،result،fetched_at
پارامترها
symbols— فیلتر چند نماد با کاماamount— مقدار برای تبدیل ارزfresh=1— عبور از کش و دریافت تازهX-API-Key— روش امن پیشنهادی برای ارسال کلید؛ Query parameter قدیمی فقط برای سازگاری حفظ شده است.
{
"ok": true,
"service": "comprehensive-prices",
"result": {
"symbol": "usd",
"name_fa": "دلار آمریکا",
"buy_toman": 0,
"sell_toman": 0
},
"usage": {"bucket":"category:2", "category":"market", "daily_limit":1000, "used":1, "remaining":999}
}
قیمت و بازار
چارت ارزهای دیجیتال
تولید چارت دقیقهای، ساعتی و روزانه با ۹ نوع نمودار، استایل Poster هوشمند و خروجی SVG، JPG، JSON، CSV و آمار خلاصه؛ نمادهای اصلی تم اختصاصی دارند و سایر نمادها بر اساس رتبه بازار رنگبندی میشوند.
/crypto-chart/v1/خروجیها و Endpointها
GET /crypto-chart/v1/chart?coin=BTC&interval=1h&type=candle— تصویر SVG با استایل Poster پیشفرضGET /crypto-chart/v1/jpg?coin=BTC&interval=1h&type=candle&quality=92— تصویر JPG مستقیمGET /crypto-chart/v1/data?coin=BTC&interval=15m&limit=96— داده خام OHLC، Volume و Trades به صورت JSONGET /crypto-chart/v1/csv?coin=BTC&interval=1d&limit=90— خروجی CSVGET /crypto-chart/v1/stats?coin=BTC&interval=1h— آمار خلاصه بدون آرایه نقاطGET /crypto-chart/v1/meta— لیست تایمفریمها، نوع نمودارها، استایلها و محدودیتها- پایداری داده: RAVA بهترتیب از Bybit، OKX و Endpointهای رسمی Binance استفاده میکند و در صورت اختلال Provider بهصورت خودکار منبع بعدی را امتحان میکند.
پارامترها
coin— نام، نماد یا نام فارسی رایج؛ مثلBTC،ethereumیابیت کوینinterval—1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1dlimit— بین ۲ تا ۱۰۰۰ کندل/نقطهtype—line, area, smooth, step, candle, ohlc, heikin, volume, candle-volumestyle—poster(پیشفرض)،rava, classic, neon, glass, minimal, terminal, ocean, sunset. نامهایcard،smartوassetنیز معادل Poster هستند.theme—darkیاlightquote—USDT, USDC, FDUSD, BTCwidth— ۶۴۰ تا ۲۰۰۰؛height— ۳۶۰ تا ۱۲۰۰quality— کیفیت JPG از ۶۰ تا ۱۰۰؛ پیشفرض ۹۲download=1— دانلود مستقیم SVG، JPG یا CSV با نام فایل مناسبpretty=1— JSON خواناتر برای تست و دیباگdays— سازگاری با نسخه قبلی؛ در صورت نبودintervalمیتوان از تعداد روز استفاده کرد.
نمونهها
curl 'https://ravaapi.pro/crypto-chart/v1/jpg?coin=BTC&interval=1h&limit=72&type=candle&quality=92' -H 'X-API-Key: YOUR_API_KEY' -o btc.jpg
<?php
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$jpg = file_get_contents('https://ravaapi.pro/crypto-chart/v1/jpg?coin=BTC&interval=1h&limit=72&type=candle&quality=92', false, $context);
file_put_contents('btc.jpg', $jpg);
const r = await fetch('https://ravaapi.pro/crypto-chart/v1/data?coin=BTC&interval=15m&limit=96', {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await r.json();
console.log(data.result.points);
import requests
r = requests.get('https://ravaapi.pro/crypto-chart/v1/data', params={'coin':'BTC','interval':'15m','limit':96}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['result']['stats'])
ساختار JSON
{
"ok": true,
"service": "crypto-chart",
"result": {
"coin": {"name": "Bitcoin", "symbol": "BTC"},
"market": {"symbol": "BTCUSDT", "quote": "USDT"},
"period": {"interval": "1h", "limit": 72},
"stats": {"last_price": 0, "change_percent": 0},
"points": [{"timestamp":"...","open":0,"high":0,"low":0,"close":0,"volume":0}]
},
"usage": {"bucket":"category:2", "category":"market", "daily_limit":1000, "used":1, "remaining":999}
}
مسیر /chart خروجی image/svg+xml و مسیر /jpg خروجی image/jpeg میدهد. برای JPG ابتدا Imagick و سپس GD بهعنوان Backend استفاده میشود؛ وضعیت Backend در /meta قابل مشاهده است.
ساختار پاسخ هوش مصنوعی
{
"ok": true,
"model": "claudehaiku45",
"response": "متن پاسخ مدل",
"usage": {"bucket":"ai", "category":"ai", "daily_limit":100, "used":1, "remaining":99},
"latency_ms": 1234
}
Anthropic1 مدل فعال
Anthropic
Claude Haiku 4.5
مدل سریع Claude برای متن، خلاصهسازی و تحلیل
/claudehaiku45/curl -G 'https://ravaapi.pro/claudehaiku45/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/claudehaiku45/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/claudehaiku45/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/claudehaiku45/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
DeepSeek2 مدل فعال
DeepSeek
DeepSeek V3
مدل عمومی DeepSeek برای متن و کدنویسی
/deepseekv3/curl -G 'https://ravaapi.pro/deepseekv3/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/deepseekv3/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/deepseekv3/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/deepseekv3/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
DeepSeek
DeepSeek R1
مدل استدلالی برای مسائل چندمرحلهای
/deepseekr1/curl -G 'https://ravaapi.pro/deepseekr1/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/deepseekr1/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/deepseekr1/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/deepseekr1/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
Google2 مدل فعال
Google
Gemini 3 Flash
مدل سریع خانواده Gemini برای پاسخهای روزمره
/gemini3flash/curl -G 'https://ravaapi.pro/gemini3flash/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gemini3flash/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gemini3flash/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gemini3flash/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
Google
Gemini Lite
نسخه سبک Gemini برای مصرف سریع
/geminilite/curl -G 'https://ravaapi.pro/geminilite/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/geminilite/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/geminilite/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/geminilite/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI7 مدل فعال
OpenAI
GPT-5.2
مدل عمومی پیشرفته برای کدنویسی، تحلیل و متن
/gpt52/curl -G 'https://ravaapi.pro/gpt52/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt52/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt52/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt52/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-5
مدل عمومی قدرتمند برای پروژههای حرفهای
/gpt5/curl -G 'https://ravaapi.pro/gpt5/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt5/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt5/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt5/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-5 Mini
تعادل مناسب میان سرعت و کیفیت
/gpt5mini/curl -G 'https://ravaapi.pro/gpt5mini/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt5mini/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt5mini/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt5mini/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-5 Nano
نسخه سبک برای درخواستهای سریع و ساده
/gpt5nano/curl -G 'https://ravaapi.pro/gpt5nano/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt5nano/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt5nano/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt5nano/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-4o
مدل چندمنظوره سریع برای متن و گفتگو
/gpt4o/curl -G 'https://ravaapi.pro/gpt4o/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt4o/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt4o/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt4o/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-4o Mini
مدل اقتصادی و سریع برای پروژههای سبک
/gpt4omini/curl -G 'https://ravaapi.pro/gpt4omini/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt4omini/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt4omini/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt4omini/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
OpenAI
GPT-5.6 Luna
مدل پیشرفته موجود در سرویس بالادستی
/gpt56luna/curl -G 'https://ravaapi.pro/gpt56luna/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/gpt56luna/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/gpt56luna/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/gpt56luna/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
xAI2 مدل فعال
xAI
Grok 4.3
مدل عمومی قدرتمند برای تحلیل، گفتگو و تولید محتوا
/grok43/curl -G 'https://ravaapi.pro/grok43/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/grok43/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/grok43/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/grok43/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
xAI
Grok 3 Mini
نسخه سبکتر و سریعتر خانواده Grok
/grok3mini/curl -G 'https://ravaapi.pro/grok3mini/' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'text=سلام'
<?php
$url = 'https://ravaapi.pro/grok3mini/?text=' . urlencode('سلام');
$context = stream_context_create(['http'=>['header'=>'X-API-Key: YOUR_API_KEY']]);
$response = file_get_contents($url, false, $context);
echo $response;
const url = new URL('https://ravaapi.pro/grok3mini/');
url.searchParams.set('text', 'سلام');
const res = await fetch(url, {headers:{'X-API-Key':'YOUR_API_KEY'}});
const data = await res.json();
console.log(data.response);
import requests
r = requests.get('https://ravaapi.pro/grok3mini/', params={'text':'سلام'}, headers={'X-API-Key':'YOUR_API_KEY'})
print(r.json()['response'])
POST 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— سهمیه روزانه همان دسته تمام شده؛ نام دسته درquota.categoryبرمیگردد502 provider_error— سرویس مدل بالادستی پاسخ موفق نداده502 upstream_or_parser_error— دریافت یا پردازش قیمت بازار موقتاً ناموفق بوده