Media Generation

Generate images, videos, and remove captions/watermarks from videos. All media endpoints use studio credits and follow the same async job pattern — submit a request, receive a job_id, then poll /api/job-status/:job_id for results. Image and video generation are available on all plans; caption removal requires a Professional or Ultimate plan.

POST /api/caption-remover

Remove captions and watermarks from a video. Accepts a publicly accessible video URL or a TikTok/Instagram Reel link — the API downloads and processes the video via AI, then returns a cleaned video uploaded to CDN. Credits are deducted upfront and refunded automatically if processing fails.

Request Body (JSON)

Name	Type	Required	Description
video_url	string	Required	Direct video URL, TikTok link (`https://www.tiktok.com/@user/video/{id}`), or Instagram Reel link (`https://www.instagram.com/reels/{id}/`)

Cost: 12 studio credits per minute of video (0.2 credits per second, rounded up). Max duration: 90 seconds. Processing can take up to 30 minutes depending on video length.

Example Request (Direct URL)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://example.com/my-video.mp4"}'

Example Request (TikTok)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://www.tiktok.com/@username/video/1234567890123456789"}'

Example Request (Instagram Reel)

curl -X POST "https://api.algrow.online/api/caption-remover" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"video_url": "https://www.instagram.com/reels/DWPuSZWATDC/"}'

Response 200 200

{
                  "success": true,
                  "job_id": "a5358a1c-388d-47a3-989e-755291031d77",
                  "status": "pending",
                  "duration_seconds": 28.5,
                  "credit_cost": 6,
                  "message": "Caption removal queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "a5358a1c-388d-47a3-989e-755291031d77",
                  "job_type": "caption_remover",
                  "status": "completed",
                  "output_url": "https://audio.algrow.online/api/video/caption_remover_abc123.mp4",
                  "completed_at": 1774200779.08
                }

200 Queued 400 Missing video_url 401 Auth failed 402 No credits 403 Plan required 429 Too busy

POST /api/generate-image

Generate AI images from a text prompt. Supports multiple models with optional reference images. Returns one or more image URLs uploaded to CDN. Credits are deducted upfront and refunded automatically if generation fails. Set fast=true to bypass the standard ladder for sub-30s outputs (3x the model's base credits, never less than 3).

Request Body (JSON)

Name	Type	Required	Default	Description
prompt	string	Required	—	Text description of the image to generate
model	string	Optional	nano-banana-2	Image model. See model table below.
aspect_ratio	string	Optional	16:9	Output aspect ratio (e.g. `16:9`, `9:16`, `1:1`, `4:3`)
reference_image_url	string	Optional	—	URL of a reference image for style guidance. Required for `seedream-4.5-edit`.
reference_image_urls	string[]	Optional	—	Several reference images at once. Takes precedence over `reference_image_url`, which is used as a fallback when only one reference is sent. `nano-banana-pro`, `nano-banana-2`, `seedream-5.0-lite` and `gpt-image-2` use the whole list; the others take the first entry only.
fast	boolean	Optional	false	Fast mode — bypasses the standard provider ladder for sub-30s outputs. Costs 3x the model's base credits, never less than 3. Same models and prompt; reference images still work.
use_own_key	boolean	Optional	true	Use your own provider key for this render when you have one configured. Set to `false` to spend Algrow credits instead. No effect if you haven't added a key.

Bring your own key and the render is free. Add a provider key at Settings and any model it covers renders on that key at 0 Algrow credits — you pay the provider directly. It applies automatically; the credits_used field in the response comes back as 0 so you can tell which path a job took. Pass use_own_key: false on a request you would rather bill to credits.

Available Models

Model	Credits	Notes
`gpt-image-2`	0.35	OpenAI GPT Image 2 — text-to-image, or image-to-image when `reference_image_url` is supplied
`nano-banana-2`	1	Fast general-purpose generation (default)
`nano-banana-pro`	2	Higher quality, supports up to 8 reference images
`seedream-4.5-edit`	1	Image editing — requires `reference_image_url`
`seedream-5.0-lite`	1	Lightweight generation, optional reference

Example Request

curl -X POST "https://api.algrow.online/api/generate-image" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a sunset over mountains, photorealistic", "model": "nano-banana-2", "aspect_ratio": "16:9"}'

Example Request (fast mode)

curl -X POST "https://api.algrow.online/api/generate-image" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a sunset over mountains, photorealistic", "model": "nano-banana-2", "aspect_ratio": "16:9", "fast": true}'

Response 200 200

{
                  "success": true,
                  "job_id": "536c20ce-5ee6-4b8d-9f7f-3994014c896e",
                  "status": "pending",
                  "credits_used": 1,
                  "message": "Image generation queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "536c20ce-5ee6-4b8d-9f7f-3994014c896e",
                  "job_type": "image",
                  "status": "completed",
                  "image_urls": ["https://audio.algrow.online/api/images/user123/1774201509_0_5b0a0050.png"],
                  "completed_at": 1774201512.99
                }

200 Queued 400 Validation error 401 Auth failed 402 No credits 403 Plan required 429 Too busy

POST /api/generate-video

Generate AI videos from a text prompt. Supports multiple models including Sora, Veo, Seedance, Kling, and Grok. Returns a video URL uploaded to CDN. Credits are deducted upfront and refunded automatically if generation fails.

Request Body (JSON)

Name	Type	Required	Default	Description
prompt	string	Required	—	Text description of the video to generate
model	string	Optional	sora-2	Video model. See model table below.
input_reference_url	string	Conditional	—	Reference image URL. Required for `kling-2.6` and `grok-image-to-video`. Optional on every other model.
seconds	string	Optional	4	Video duration in seconds (Sora only). Values: `4`, `8`, `12`. Anything else falls back to `4`.
size	string	Optional	720x1280	Output resolution (Sora only). Values: `720x1280`, `1280x720`, and on `sora-2-pro` also `1024x1792`, `1792x1024`. Any other value returns 400 — there is no 1080p Sora tier.
duration	string	Optional	5	Video duration for Kling (`5` or `10`), Grok (`6`–`30`) and Seedance (`4`–`15`; `1`–`30` on `seedance-2-5`). Out-of-range values are clamped, and you are billed the clamped duration.
resolution	string	Optional	—	Output resolution for Veo (`720p`, `1080p`, `4k`), Grok (`480p`, `720p`, `1080p`) and Seedance (`480p`, `720p`, plus `1080p` / `4k` on `seedance-2`). Unsupported values fall back to the model's default tier.
sound	boolean	Optional	false	Enable audio generation (Kling and Seedance). Raises the credit cost. `seedance-2-5` includes audio at no extra cost.
aspect_ratio	string	Optional	9:16	Output aspect ratio (Veo only). e.g. `9:16`, `16:9`

Available Models

Model	Credits	Reference Image	Notes
`sora-2`	14 / 27 / 40	Optional	OpenAI Sora 2, 720p. Cost by `seconds`: 4s / 8s / 12s
`sora-2-pro`	40 / 80 / 120 (720p) 67 / 134 / 200 (1024p)	Optional	Sora 2 Pro. Cost by `seconds` 4s / 8s / 12s, and by `size` tier
`veo3-lite`	5 / 6 / 25	Optional	Google Veo 3.1 Lite. Cost by `resolution`: 720p / 1080p / 4k
`veo3-fast`	10 / 11 / 30	Optional	Veo 3.1 Fast. Cost by `resolution`: 720p / 1080p / 4k
`veo3-quality`	42 / 43 / 62	Optional	Veo 3.1 Quality. Cost by `resolution`: 720p / 1080p / 4k
`kling-2.6`	10 / 19 19 / 37 with sound	Required	Image-to-video. Cost by `duration` 5s / 10s, doubled by `sound`
`grok-image-to-video`	3 – 40	Required	Grok image-to-video. Billed per second by `duration` (6–30s) and `resolution`
`grok-text-to-video`	3 – 40	Optional	Grok text-to-video. Same per-second rates as above
`seedance-2-mini`	4 – 52	Optional	Cheapest Seedance tier. 480p / 720p, 4–15s, optional `sound`
`seedance-2-fast`	6 – 83	Optional	Faster Seedance tier. 480p / 720p, 4–15s, optional `sound`
`seedance-2`	8 – 520	Optional	Full Seedance. Adds 1080p and 4k, 4–15s, optional `sound`
`seedance-2-5`	5 – 315	Optional	Newest Seedance, up to 30s. 480p / 720p only; audio is included at no extra cost

Costs are computed from the parameters you send. Duration is clamped and resolution snapped to the nearest supported tier before billing, so the credits you are charged always match the video you get back. The exact figure is in the credit_cost field of the 200 response.

Example Request (Sora)

curl -X POST "https://api.algrow.online/api/generate-video" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "a cat walking through flowers", "model": "sora-2", "seconds": "4", "size": "720x1280"}'

Example Request (Kling with reference image)

curl -X POST "https://api.algrow.online/api/generate-video" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "person waving at camera", "model": "kling-2.6", "input_reference_url": "https://example.com/photo.jpg", "duration": "5"}'

Response 200 200

{
                  "success": true,
                  "job_id": "e58464d7-ae8d-41b2-8c52-79bac92b1bb9",
                  "status": "pending",
                  "credit_cost": 14,
                  "message": "Video generation queued. Poll /api/job-status/{job_id} for progress."
                }

Completed Job Response (via /api/job-status/:job_id)

{
                  "success": true,
                  "job_id": "e58464d7-ae8d-41b2-8c52-79bac92b1bb9",
                  "job_type": "video",
                  "status": "completed",
                  "video_url": "https://audio.algrow.online/sora/videos/user123/video_abc123.mp4",
                  "completed_at": 1774200881.01
                }

Processing time: Video generation can take 30 seconds to 30 minutes depending on the model and duration. Poll /api/job-status/:job_id every 5 seconds for updates.

200 Queued 400 Validation error 401 Auth failed 402 No credits 403 Plan required 429 Too busy

Buy More Credits