ideogram-v3:pixelافتراضيالأرخصIdeogram v3 API — كيفية الاتصال والدفع
Ideogram v3 — عرض ممتاز للنصوص على الصور. الأوضاع: التوليد، وإعادة المزج، والقص (الوضعان الأخيران — Pixel فقط)؛ التحرير دون قناع — Canvas فقط.
مقارنة القنوات
آخر 7 أيام
ideogram-v3:rep| القناة | السعر |
|---|---|
Pixel ideogram-v3:pixelافتراضيالأرخص | يبدأ من $0.023333 per image |
لوحة الرسم ideogram-v3:rep | يبدأ من $0.04 per image |
أنشئ النتيجة التي تحتاج إليها
ideogram-v3:pixelما هو Ideogram v3
Ideogram v3 — عرض ممتاز للنصوص على الصور. الأوضاع: التوليد، وإعادة المزج، والقص (الوضعان الأخيران — Pixel فقط)؛ التحرير دون قناع — Canvas فقط.
ملخص العقد
- الإدخال
- text, image
- الإخراج
- image
- الوضع
- غير متزامن (مهمة + استعلام دوري)
- الاستعلام عن الحالة
- كل 3 ثوانٍ · حتى 90 ثانية
نقاط القوة
- التسعير: لكل صورة
- المدخلات: نص، صورة
- 5 خيارات قابلة للتهيئة
- مفتاح API واحد لتوليد الوسائط
أين يُستخدم
- رسوم توضيحية للمقالات ووسائل التواصل الاجتماعي
- صور المنتجات
- اللافتات والأغلفة
- نماذج التصميم الأولية
عقد API
تتم عملية الإنشاء بشكل غير متزامن: أنشئ مهمة، ثم استعلم عن حالتها حتى تكتمل.
- إنشاء مهمة
- POST /api/media/generate
- التحقق من الحالة
- GET /api/media/jobs/{jobId}
- الإدخال
- text, image
- الإخراج
- image
- الاستعلام الدوري
- كل 3 ثوانٍ · حتى 90 ثانية
- المصادقة
- Authorization: Bearer sk-pv-…
مثال على طلب
مرّر مفتاحك في ترويسة Bearer. تُرجع API jobId للاستعلام عن الحالة.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"ideogram-v3:pixel","prompt":"a beautiful landscape","opts":{"mode":"text-to-image","aspect_ratio":"1:1","rendering_speed":"DEFAULT","style":"AUTO","expand_prompt":false,"num_images":"1"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "ideogram-v3:pixel",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-image",
"aspect_ratio": "1:1",
"rendering_speed": "DEFAULT",
"style": "AUTO",
"expand_prompt": false,
"num_images": "1"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);معلمات طلب API
معلمات الطلبات إلى Ideogram v3 عبر GetVibe API.
promptمطلوبimage_urlaspect_ratiomoderendering_speedstyleexpand_promptseednegative_promptstrengthnum_imagesimage_file_idimage_base64| المعلمة | النوع | القيم | الافتراضي | السعر |
|---|---|---|---|---|
promptمطلوب | text | text description | required | — |
image_url | URL | Public image URL | — | — |
aspect_ratio | option selection | 1:1 (default) · 16:9 · 9:16 · 4:3 · 3:4 | 1:1 | Included in the base price |
mode | option selection | Generate (text → image) (default) · Edit (Canvas only) · Remix · Reframe | توليد (نص → صورة) | Included in the base price |
rendering_speed | option selection | Turbo · Default (default) · Quality | افتراضي | Turbo: $0.023333, Default: $0.046667, Quality: $0.066667 |
style | option selection | Auto (default) · General · Realistic · Design | تلقائي | Included in the base price |
expand_prompt | yes/no | Yes · No (default) | لا | Included in the base price |
seed | text / number | any value | — | Included in the base price |
negative_prompt | text / number | any value | — | Included in the base price |
strength | option selection | 0.8 (default) (default) · 0.2 · 0.4 · 0.6 · 1.0 | 0.8 (default) | Included in the base price |
num_images | option selection | 1 (default) · 2 · 3 · 4 | 1 | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
الطلب: POST https://getvibeapi.com/api/media/generate. الأسعار بالدولار الأمريكي.
سعر Ideogram v3
تكلفة Ideogram v3: من $0.023333 per image. يُحتسب السعر ديناميكيًا وفق سعر الصرف الحالي، وتظهر التكلفة النهائية في استجابة API (priceRub). الدفع بالدولار الأمريكي، دون اشتراكات.
تكلفة الطلب الافتراضي
عند عدم إرسال أي معلمات، يستخدم الطلب هذه القيم: Generation speed — Default, Mode — Generate (text → image), Frame format — 1:1, Style — Auto. تبلغ تكلفة هذا الطلب $0.046667.
«من $0.023333» هي أرخص مجموعة من المعلمات، وليست سعر الطلب الافتراضي.
القنوات والأسعار لكل مجموعة من المعلمات
لكل قناة، سعر كل مجموعة من المعلمات. هذا هو المبلغ المحدد الذي تُحاسَب عليه عملية الإنشاء الناجحة، وهو الرقم نفسه الوارد في الجدول القابل للقراءة آليًا المرتبط أدناه.
Pixelideogram-v3:pixelيبدأ من $0.023333أسعار دقيقة
| السرعة | Turbo | افتراضي | الجودة |
|---|---|---|---|
| Pixel | $0.023333 | $0.046667 | $0.066667 |
كل مجموعة بصيغة JSON: /api/media/price-table?model=ideogram-v3%3Apixel
لوحة الرسمideogram-v3:repيبدأ من $0.04أسعار دقيقة
| السرعة | Turbo | افتراضي | الجودة |
|---|---|---|---|
| لوحة الرسم | $0.04 | $0.08 | $0.12 |
كل مجموعة بصيغة JSON: /api/media/price-table?model=ideogram-v3%3Arep
README
يحتوي العقد القابل للقراءة آليًا لـ Ideogram v3 على مخطط الطلب، والعمليات، والحدود، وأمثلة الاستطلاع والاستجابة.
# Ideogram v3
نموذج عام: ideogram-v3:pixel
إنشاء مهمة: POST /api/media/generate
التحقق من الحالة: GET /api/media/jobs/{jobId}
## معلمات الإدخال
- `prompt` (text): text description; افتراضي: required
- `image_url` (URL): Public image URL; افتراضي: —
- `aspect_ratio` (option selection): 1:1 (default) · 16:9 · 9:16 · 4:3 · 3:4; افتراضي: 1:1
- `mode` (option selection): Generate (text → image) (default) · Edit (Canvas only) · Remix · Reframe; افتراضي: Generate (text → image)
- `rendering_speed` (option selection): Turbo · Default (default) · Quality; افتراضي: Default
- `style` (option selection): Auto (default) · General · Realistic · Design; افتراضي: Auto
- `expand_prompt` (yes/no): Yes · No (default); افتراضي: No
- `seed` (text / number): any value; افتراضي: —
- `negative_prompt` (text / number): any value; افتراضي: —
- `strength` (option selection): 0.8 (default) (default) · 0.2 · 0.4 · 0.6 · 1.0; افتراضي: 0.8 (default)
- `num_images` (option selection): 1 (default) · 2 · 3 · 4; افتراضي: 1
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); افتراضي: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; افتراضي: —
## الأنواع العامة
- `ideogram-v3:pixel`: Pixel
- `ideogram-v3:rep`: Canvasالأسئلة الشائعة حول واجهة برمجة تطبيقات Ideogram v3
كم تبلغ تكلفة Ideogram v3؟
سعر Ideogram v3: من $0.023333 per image. يُحتسب السعر ديناميكيًا وفق سعر الصرف الحالي.
هل يتوافق مع OpenAI SDK؟
نعم، واجهة برمجة التطبيقات متوافقة بالكامل مع OpenAI. ما عليك سوى تغيير base_url إلى https://getvibeapi.com/v1 وإضافة مفتاحك — وستبقى بقية الشفرة كما هي.
اربط Ideogram v3 الآن
أنشئ حسابًا خلال دقيقة، وادفع حسب الاستخدام، واستفد من الشفرة الجاهزة أعلاه.
الحصول على مفتاح API