This API provides AI-powered image generation using Replicate's Flux model. It supports both authenticated access with the service's built-in token and user-provided Replicate API tokens.

https://your-val-town-url.web.val.run

Use the service's built-in Replicate token by providing the service's AUTH_TOKEN:

curl -H "Authorization: Bearer YOUR_SERVICE_AUTH_TOKEN" \
     "https://your-val-town-url.web.val.run/generate?prompt=a%20beautiful%20sunset"

Provide your own Replicate API token to bypass service authentication. This allows you to use your own Replicate credits and quotas without needing the service's AUTH_TOKEN.

Key Benefits:

• No need for service authentication
• Use your own Replicate credits and limits
• Direct control over API usage
• Bypass service rate limits

Generate an image and redirect to the image URL.

Endpoint: GET /generate

Parameters:

• prompt (required): Text description of the image to generate
• replicate_token (optional): Your Replicate API token

Authentication Options:

• With service token: Include Authorization: Bearer YOUR_SERVICE_AUTH_TOKEN header
• With user token: Include replicate_token parameter (no Authorization header needed)

Examples:

Using service authentication:

curl -H "Authorization: Bearer YOUR_SERVICE_AUTH_TOKEN" \
     "https://your-val-town-url.web.val.run/generate?prompt=a%20cat%20wearing%20sunglasses"

Using your own Replicate token:

curl "https://your-val-town-url.web.val.run/generate?prompt=a%20cat%20wearing%20sunglasses&replicate_token=r8_YOUR_REPLICATE_TOKEN"

Response:

• Status: 302 (Redirect)
• Location header contains the generated image URL

Generate an image and return JSON with image details.

Endpoint: POST /generate

Request Body:

{
  "prompt": "a beautiful landscape",
  "replicate_token": "r8_YOUR_REPLICATE_TOKEN" // optional
}

Authentication Options:

• With service token: Include Authorization: Bearer YOUR_SERVICE_AUTH_TOKEN header
• With user token: Include replicate_token in request body (no Authorization header needed)
• With user token (header): Include X-Replicate-Token: r8_YOUR_REPLICATE_TOKEN header

Examples:

Using service authentication:

curl -X POST \
     -H "Authorization: Bearer YOUR_SERVICE_AUTH_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"prompt": "a futuristic city"}' \
     https://your-val-town-url.web.val.run/generate

Using your own Replicate token (in body):

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"prompt": "a futuristic city", "replicate_token": "r8_YOUR_REPLICATE_TOKEN"}' \
     https://your-val-town-url.web.val.run/generate

Using your own Replicate token (in header):

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-Replicate-Token: r8_YOUR_REPLICATE_TOKEN" \
     -d '{"prompt": "a futuristic city"}' \
     https://your-val-town-url.web.val.run/generate

Response:

{
  "id": "generated_image_1234567890.png",
  "imageUrl": "https://your-val-town-url.web.val.run/image/generated_image_1234567890.png"
}

Get a previously generated image.

Endpoint: GET /image/{imageId}

Parameters:

• imageId: The image ID returned from the generate endpoint

Authentication: None required for image retrieval

Example:

curl https://your-val-town-url.web.val.run/image/generated_image_1234567890.png

Response:

• Content-Type: image/png
• Binary image data

When multiple token sources are provided, the API uses this priority order:

1. X-Replicate-Token header
2. replicate_token in request body (POST only)
3. replicate_token query parameter (GET only)
4. Service's built-in REPLICATE_API_TOKEN (default)

{
  "error": "Missing 'prompt' query parameter"
}

Unauthorized access 🚫

Not Found

or

Image not found

{
  "error": "Failed to generate image",
  "details": "Specific error message"
}

1. Sign up at replicate.com
2. Go to your account settings
3. Generate an API token
4. The token will start with r8_

• Use the built-in authentication to control access
• Monitor usage through your service logs
• Manage costs through your Replicate account

• Use your own Replicate token to:
  • Avoid service rate limits
  • Use your own Replicate credits
  • Have direct control over API usage
  • Bypass service authentication requirements

Rate limits depend on the Replicate token being used:

• Service token: Subject to the service owner's Replicate plan
• User token: Subject to your own Replicate plan and limits

This service uses the black-forest-labs/flux-schnell model on Replicate, which:

• Generates high-quality images
• Supports various artistic styles
• Outputs PNG format images
• Typically takes 2-10 seconds to generate

// Using service authentication
const response = await fetch('https://your-val-town-url.web.val.run/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_SERVICE_AUTH_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'a magical forest with glowing mushrooms'
  })
});

const result = await response.json();
console.log('Generated image:', result.imageUrl);

// Using your own Replicate token
const responseWithUserToken = await fetch('https://your-val-town-url.web.val.run/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Replicate-Token': 'r8_YOUR_REPLICATE_TOKEN'
  },
  body: JSON.stringify({
    prompt: 'a magical forest with glowing mushrooms'
  })
});

const resultWithUserToken = await responseWithUserToken.json();
console.log('Generated image:', resultWithUserToken.imageUrl);

import requests

# Using service authentication
response = requests.post(
    'https://your-val-town-url.web.val.run/generate',
    headers={
        'Authorization': 'Bearer YOUR_SERVICE_AUTH_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'prompt': 'a serene mountain landscape'
    }
)

result = response.json()
print(f"Generated image: {result['imageUrl']}")

# Using your own Replicate token
response_with_user_token = requests.post(
    'https://your-val-town-url.web.val.run/generate',
    headers={
        'Content-Type': 'application/json',
        'X-Replicate-Token': 'r8_YOUR_REPLICATE_TOKEN'
    },
    json={
        'prompt': 'a serene mountain landscape'
    }
)

result_with_user_token = response_with_user_token.json()
print(f"Generated image: {result_with_user_token['imageUrl']}")

• Keep your Replicate API tokens secure
• Don't expose tokens in client-side code
• Use environment variables for token storage
• The service stores generated images temporarily in blob storage
• Images are accessible via direct URL without authentication

1. "Unauthorized access": Check your Authorization header or provide a valid replicate_token
2. "Missing 'prompt' parameter": Ensure you include a prompt in your request
3. "Replicate API error": Check your Replicate token validity and account limits
4. "Prediction timed out": The image generation took too long; try again with a simpler prompt

• Check the service logs for detailed error messages
• Verify your Replicate token at replicate.com
• Ensure your prompt is descriptive but not overly complex
• Check your Replicate account for usage limits and billing status