Quickstart

​

Requirements

• A Runpod account with at least $1 in credits
• A Runpod API key

​

Step 1: Generate an image in the playground

1. Go to the Flux Schnell endpoint in the Runpod console.
2. Under Input, enter a prompt: A golden retriever playing fetch on a sunny beach (or any other prompt you like).
3. Click Run.
4. Wait a few seconds for the image to generate. The result appears under Result.

​

Step 2: Generate an image with the API

curl -X POST "https://api.runpod.ai/v2/black-forest-labs-flux-1-schnell/runsync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "A golden retriever playing fetch on a sunny beach",
      "width": 1024,
      "height": 1024
    }
  }'

import requests

response = requests.post(
    "https://api.runpod.ai/v2/black-forest-labs-flux-1-schnell/runsync",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "input": {
            "prompt": "A golden retriever playing fetch on a sunny beach",
            "width": 1024,
            "height": 1024,
        }
    },
)

result = response.json()
print(result["output"]["image_url"])

python generate_image.py

​

Response

{
  "status": "COMPLETED",
  "output": {
    "image_url": "https://image.runpod.ai/...",
    "cost": 0.02097152
  }
}

​

Next steps

• Make API requests: Learn about async requests, SDKs, and best practices.
• Model reference: Explore all available models and their parameters.
• Connect AI coding tools: Use Public Endpoints with Cursor, Cline, and OpenCode.
• Build a text-to-video pipeline: Chain multiple endpoints to generate videos from text prompts.