# OpenRouter APIs — Sourceful: Riverflow V2.5 Pro (sourceful/riverflow-v2.5-pro) Guide for calling every confirmed OpenRouter API that serves `sourceful/riverflow-v2.5-pro`. Model page: https://openrouter.ai/sourceful/riverflow-v2.5-pro Create an API key: https://openrouter.ai/settings/keys ## Pricing Standard-variant prices for `sourceful/riverflow-v2.5-pro`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price. - Sourceful: from $0.13/image Full price table, including other variants and per-request charges: https://openrouter.ai/sourceful/riverflow-v2.5-pro How OpenRouter prices requests: https://openrouter.ai/pricing ## EU in-region routing `sourceful/riverflow-v2.5-pro` is not currently available through EU in-region routing. Docs: https://openrouter.ai/docs/guides/features/in-region-routing ## Authentication Send this header with every request: - Authorization: Bearer $OPENROUTER_API_KEY ## Image API Generate images with `sourceful/riverflow-v2.5-pro` through OpenRouter's Image API. Docs: https://openrouter.ai/docs/guides/overview/multimodal/image-generation Model discovery API: https://openrouter.ai/api/v1/images/models Endpoints (sourceful/riverflow-v2.5-pro-20260605): https://openrouter.ai/api/v1/images/models/sourceful/riverflow-v2.5-pro-20260605/endpoints ### Endpoint POST https://openrouter.ai/api/v1/images Headers: - Content-Type: application/json ### Request fields (sourceful/riverflow-v2.5-pro) - model: string (required) — `"sourceful/riverflow-v2.5-pro"` - prompt: string (required) — text description of the desired image - resolution: "1K" | "2K" | "4K" (optional) — resolution tier; concrete pixel dimensions are derived per provider - aspect_ratio: "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "21:9" | "auto" (optional) — aspect ratio of the generated image - output_format: "png" | "jpeg" | "webp" (optional) — encoding of the returned image bytes - background: "auto" | "transparent" | "opaque" (optional) — background treatment; transparent requires png or webp output - n: integer 1-1 (optional) — upper bound on the number of images to generate; providers may return fewer, and single-image providers reject n > 1 - input_references: array of up to 10 image references (optional) — reference images for image-to-image, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries; the url is an https URL or a base64 data URL These are the generation parameters this model accepts between its providers; an unlisted value is rejected, and a listed one can still be refused by whichever provider serves the call. `provider` (routing preferences) is accepted on every request. ### Response ```json { "created": 1748372400, "data": [{ "b64_json": "", "media_type": "image/png" }], "usage": { "prompt_tokens": 0, "completion_tokens": 4175, "total_tokens": 4175, "cost": 0.04 } } ``` Base64-decode `data[i].b64_json` and write the bytes to a file; `media_type` gives the extension. `usage.cost` is the USD charge for the call. ### Examples #### Text to Image ```bash curl -X POST https://openrouter.ai/api/v1/images \ -H "Authorization: Bearer $OPENROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sourceful/riverflow-v2.5-pro", "prompt": "Editorial architectural photograph of a contemporary neighborhood storefront at blue hour, glowing warmly against the dusk. Above the entrance, a warm-white neon sign in flowing hand-bent cursive reads exactly \"OpenRouter\", the only text in the scene. Large windows reveal a cozy, lived-in interior: wood shelves styled with books and ceramics, lush trailing plants, and soft pendant lighting. Potted plants and a bicycle rest by the entrance, and golden light spills across the wet pavement in gentle reflections. Straight-on composition, realistic materials, quiet street with no people.", "n": 1, "aspect_ratio": "16:9", "resolution": "2K" }' ``` ### Error differences - 413 — request body too large ## Text / Chat Completions API Generate text with `sourceful/riverflow-v2.5-pro` through OpenRouter's Chat Completions API. Docs: https://openrouter.ai/docs/api/api-reference/chat/create-a-chat-completion ### Endpoint POST https://openrouter.ai/api/v1/chat/completions Headers: - Content-Type: application/json ### Request fields (sourceful/riverflow-v2.5-pro) - model: string (required) — `"sourceful/riverflow-v2.5-pro"` - messages: array (required) — ordered conversation messages with `role` and `content` - stream: boolean (optional) — return Server-Sent Events as tokens are generated - reasoning: optional — accepted by this model; see the API reference for its value shape - reasoning_effort: optional — accepted by this model; see the API reference for its value shape The model-specific optional fields above come from this model's advertised capabilities. `stream` and `provider` routing preferences are API controls accepted independently of that model capability list. ### Response Without `stream`, the response is a Chat Completions JSON object: ```json { "id": "gen-abc123", "choices": [{ "message": { "role": "assistant", "content": "..." } }], "usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36, "cost": 0.001 } } ``` With `stream: true`, the response is `text/event-stream`: read each `data:` JSON chunk until `data: [DONE]`. The final usage chunk carries token counts and cost when usage is requested. ### Examples #### Chat completion ```bash curl -X POST https://openrouter.ai/api/v1/chat/completions \ -H "Authorization: Bearer $OPENROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sourceful/riverflow-v2.5-pro", "messages": [ { "role": "user", "content": "What is the meaning of life?" } ] }' ``` ### Error differences - 400 — malformed messages or a parameter this model does not support - 502 — the upstream text generation failed ## Errors Failures return `{"error": {"code": , "message": }}` with the HTTP status: - 400 — malformed request or an unsupported parameter - 401 — missing or invalid API key - 402 — insufficient credits - 403 — spend limit reached, key disabled, or access blocked - 404 — unknown model or no provider can serve the request - 429 — rate limited; retry with backoff - 502 — the operation failed upstream; failed generations are not billed --- Canonical version of this document: https://openrouter.ai/sourceful/riverflow-v2.5-pro/llms.txt