رفتن به محتوا

Cosmos Predict 2.5 2B · Image to Video

یکپارچه‌سازی

شناسه مدل cosmos-predict-2.5/image-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/cosmos-predict-2.5/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۲۰⁩ ۲۰۰ اعتبار API · ≈ ⁨‎₽۲۱٫۵۲⁩ اجرای آن در این صفحه

دریافت کلید API
NVIDIA · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

توضیح متنی ویدیوی مطلوب.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویری که به‌عنوان فریم آغازین استفاده می‌شود.

پیشرفته negative_prompt · video_output_type · video_quality · num_frames · num_inference_steps · guidance_scale · seed · enable_safety_checker
پیش‌فرض The video captures a ...

پرامپت منفی برای مشخص‌کردن محتوای ناخواسته و دورکردن تولید از آن.

video_output_type پیش‌فرض X264 (.mp4)

قالب ویدیوی حاصل.

video_quality پیش‌فرض high

تنظیم کیفیت ویدیوی حاصل.

پیش‌فرض 93

تعداد فریم برای تولید، در محدوده 9 تا 93.

پیش‌فرض 35

تعداد گام‌های حذف نویز؛ با افزایش تعداد، زمان پردازش بیشتر و کیفیت بهتر می‌شود.

پیش‌فرض 7

مقیاس راهنمایی بدون طبقه‌بند؛ افزایش آن باعث می‌شود تولید بیشتر از پرامپت پیروی کند.

seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.

POST /run/cosmos-predict-2.5/image-to-video?wait=20 قیمت → ⁨‎$۰٫۲۰⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/cosmos-predict-2.5/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Cosmos Predict 2.5 2B · Image to Video

`image_url` را که به‌عنوان فریم اول استفاده می‌شود، بر اساس یک `prompt` متنی متحرک می‌کند. `num_frames` از 9 تا 93، `num_inference_steps` حداکثر 50 (پیش‌فرض 35) و `guidance_scale` از 1 تا 20 است. قالب‌های خروجی mp4، webm، mov یا GIF هستند و چهار سطح کیفیت وجود دارد.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
توضیح متنی ویدیوی مطلوب.
negative_promptاختیاری
نوعstring
پیش‌فرضThe video captures a series of frames showing ugly scenes, static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, artifacting, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, visual noise, and flickering. Overall, the video is of poor quality.
پرامپت منفی برای مشخص‌کردن محتوای ناخواسته و دورکردن تولید از آن.
num_framesاختیاری
نوعinteger
پیش‌فرض93
۹ – ۹۳
تعداد فریم برای تولید، در محدوده 9 تا 93.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض35
۱ – ۵۰
تعداد گام‌های حذف نویز؛ با افزایش تعداد، زمان پردازش بیشتر و کیفیت بهتر می‌شود.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض7
۱ – ۲۰
مقیاس راهنمایی بدون طبقه‌بند؛ افزایش آن باعث می‌شود تولید بیشتر از پرامپت پیروی کند.
seedاختیاری
نوعinteger | null
seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.
video_output_typeاختیاری
نوعenum
پیش‌فرضX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
قالب ویدیوی حاصل.
video_qualityاختیاری
نوعenum
پیش‌فرضhigh
lowmediumhighmaximum
تنظیم کیفیت ویدیوی حاصل.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
image_urlالزامی image
نوعurl · image
URL تصویری که به‌عنوان فریم آغازین استفاده می‌شود.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "cosmos-predict-2.5/image-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}فایل ویدیویی تولیدشده.
seed
integerseed کنترل‌کننده تصادفی‌بودن هنگام تولید.

مدل‌های بیشتر: تصویر به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/cosmos-predict-2.5/image-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt