Generate Photos

Skytells provides powerful AI models for generating high-quality photos from text descriptions or existing images. This guide explains how to use our photo generation APIs to create visually stunning images for your applications.

The Photo Generation Process

Photo generation with Skytells follows a straightforward process: provide a prompt or input image, select a model, customize generation parameters, and receive your generated photos. Let's explore each step in detail.

Supported Models

For a complete list of models, versions, and capabilities, see our Models Reference.

Generate Photo

The simplest way to generate a photo is by providing a text prompt to our TrueFusion model.

curl -X POST "https://api.skytells.ai/v1/predict" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "model": "truefusion",
    "safety_check": true,
    "input": {
      "prompt": "A beautiful sunset over a calm ocean with silhouette of palm trees"
    }
  }'

{
  "id": "pred_abc123def456",
  "status": "processing",
  "created_at": "2023-06-21T14:22:35.625Z",
  "model": "truefusion",
  "input": {
    "prompt": "A beautiful sunset over a calm ocean with silhouette of palm trees"
  },
  "logs": "Starting image generation process...",
  "error": null,
  "output": null
}

Advanced Photo Prediction

curl -X POST "https://api.skytells.ai/v1/predict" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "model": "truefusion",
    "input": {
      "image": "https://example.com/path/to/image.jpg",
      "prompt": "Convert to oil painting style"
    },
    "strength": 0.7
  }'

Synchronous vs. Asynchronous Generation

curl -X POST "https://api.skytells.ai/v1/predict" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "model": "truefusion",
    "input": {
      "prompt": "A beautiful sunset over a calm ocean"
    },
    "await": true
  }'

{
  "id": "pred_abc123def456",
  "status": "succeeded",
  "created_at": "2023-06-21T14:22:35.625Z",
  "completed_at": "2023-06-21T14:23:12.419Z",
  "model": "truefusion",
  "input": {
    "prompt": "A beautiful sunset over a calm ocean"
  },
  "logs": "Generation completed successfully.",
  "error": null,
  "output": [
    "https://storage.skytells.ai/generations/images/abcd1234.png"
  ]
}

Fetch Prediction

curl -X GET "https://api.skytells.ai/v1/predictions/pred_abc123def456" \
  -H "x-api-key: your-api-key-here"

{
  "id": "pred_abc123def456",
  "status": "succeeded",
  "created_at": "2023-06-21T14:22:35.625Z",
  "completed_at": "2023-06-21T14:23:12.419Z",
  "model": "truefusion",
  "input": {
    "prompt": "A beautiful sunset over a calm ocean with silhouette of palm trees"
  },
  "logs": "Generation completed successfully.",
  "error": null,
  "output": [
    "https://storage.skytells.ai/generations/images/abcd1234.png"
  ]
}

Webhook Integration

curl -X POST "https://api.skytells.ai/v1/predict" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "model": "truefusion",
    "input": {
      "prompt": "A beautiful sunset over a calm ocean"
    },
    "webhook": {
      "url": "https://your-app.com/webhooks/skytells",
      "events": ["prediction.completed", "prediction.failed"],
      "auth_header": "X-Custom-Auth",
      "auth_token": "your-secret-token"
    }
  }'

{
  "id": "pred_abc123def456",
  "status": "succeeded",
  "created_at": "2023-06-21T14:22:35.625Z",
  "completed_at": "2023-06-21T14:23:12.419Z",
  "model": "truefusion",
  "input": {
    "prompt": "A beautiful sunset over a calm ocean"
  },
  "logs": "Generation completed successfully.",
  "error": null,
  "output": [
    "https://storage.skytells.ai/generations/images/abcd1234.png"
  ],
  "webhook_event_type": "prediction.completed"
}

Prediction Schema

All prediction operations return objects that conform to our prediction schema.

Understanding this schema helps you process results consistently.

For a detailed reference of the prediction schema, see our Prediction Schema.

Best Practices for Photo Generation

Writing Effective Prompts

• Be specific: Include details about composition, style, lighting, and subject matter
• Use descriptive language: Adjectives help define the aesthetic quality
• Specify art styles: Reference specific art styles or artists for stylistic guidance
• Include composition details: Mention perspective, framing, and focal points
• Avoid negatives: Instead of saying what you don't want, focus on what you do want

Example Prompts

A detailed portrait of a female astronaut with helmet reflections of space, digital art style, dramatic lighting, detailed features, 8k resolution, professional photography, high-end

Rate Limits and Quotas

Photo generation operations consume API credits based on the model used, resolution, and other parameters. Please refer to our billing documentation for detailed information about pricing and quotas.

{
  "error": {
    "message": "Rate limit exceeded. Please retry after 18 seconds.",
    "type": "rate_limit_error",
    "param": null,
    "code": "rate_limit_exceeded"
  }
}

Next Steps

Now that you understand how to generate photos using Skytells API, you can explore more advanced features:

• Browse our pre-trained photo models
• Learn about models fine-tuning
• Explore the full API reference
• Understand billing and credits
• Set up webhooks for async workflows