Text-to-image and reference editing
Text-to-image builds an image from a written scene description — useful when you have no source yet. Reference editing starts from existing images: you can keep the subject, composition or palette and change only the details you need. All three families accept text and reference image URLs; the list below states which inputs each one takes and how many references are available.
How pricing works
Images are usually billed per generation, so the total depends on the model, version and quality you choose, and retries also count toward your budget. No prices are quoted here: live USD rates load from the catalog on each model page and in the playground, and the estimated cost is shown before you start.
How to integrate
Open the model you need and build the request in its playground: it generates a cURL with the exact endpoint, request fields and Bearer authorization. Move the request into server code so the secret key never reaches the browser, and pass reference images as service-accessible URLs. Authentication, generation status and webhooks are described in full in the API documentation.
Billing and balance
Billing is pay-per-use: you top up your runblob balance and spend it on API generations. Top-ups are charged in USD, so budgeting matches the rates shown on each model page.