Intermediate25 minModule 1 of 3

TrueFusion Models

Understand the TrueFusion family — Skytells' native image models — and choose the right variant for every use case. speed, quality, or cost.

What you'll be able to do after this module

Select the exact right TrueFusion model for your product — whether you need a real-time preview in under 2 seconds, a high-quality production render, or a photorealistic final output.


The TrueFusion family

All TrueFusion variants share the same API. Switching models is a single string change:

ModelQualitySpeedCost/predBest for
truefusionGoodFast$0.02Drafts, prototyping
truefusion-proHighMedium$0.04Default — production apps
truefusion-maxVery highSlow$0.06Portfolio work, print
truefusion-ultraUltraSlow$0.08Maximum photorealism
truefusion-2.0Next-genMedium$0.06Best coherence, complex scenes
truefusion-edgeGoodVery fast$0.01Real-time previews (Edge only)
truefusion-panoHighMedium$0.05Panoramic / wide-format output

TrueFusion Pro — the production default

truefusion-pro hits the best balance of quality, speed, and cost for most products:

curl -X POST https://api.skytells.ai/v1/predictions \
  -H "x-api-key: $SKYTELLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "truefusion-pro",
    "input": {
      "prompt": "Professional headshot, studio lighting, neutral background, sharp focus",
      "negative_prompt": "blurry, watermark, text, distorted, low quality",
      "width": 1024,
      "height": 1024,
      "num_inference_steps": 30,
      "guidance_scale": 7.5
    }
  }'

TrueFusion Edge — for real-time apps

When your app needs near-instant responses (live previews as the user types, real-time generation), use truefusion-edge. Average generation time: under 2 seconds.

// app/api/preview/route.ts
export const runtime = 'edge'; // Next.js Edge Runtime

import Skytells from '@skytells/sdk';

export async function POST(req: Request) {
  const { prompt } = await req.json();

  const client = Skytells(process.env.SKYTELLS_API_KEY, {
    baseUrl: 'https://edge.skytells.ai/v1',
  });

  const prediction = await client.predictions.create({
    model: 'truefusion-edge',
    input: {
      prompt,
      width: 512,
      height: 512,
      num_inference_steps: 4, // 4 steps = ultra-fast, good preview quality
    },
  });

  return Response.json({ url: prediction.output![0] });
}

TrueFusion 2.0 — complex scenes and coherence

truefusion-2.0 is the recommended upgrade when you need:

  • Complex multi-subject compositions
  • Accurate text rendering within images
  • Better spatial coherence (objects in the right place)
  • Following detailed or unusual instructions precisely
{
  "model": "truefusion-2.0",
  "input": {
    "prompt": "A coffee shop interior with 3 people working on laptops, afternoon light, plants in the background, warm atmosphere",
    "width": 1024,
    "height": 768,
    "num_inference_steps": 35,
    "guidance_scale": 8.0
  }
}

Third-party models via the same API

Beyond TrueFusion, Skytells gives you access to top models from other providers — same x-api-key, same endpoint:

ModelProviderStrength
google-imagen-4GooglePhotorealism, following instructions
flux-2-proBlack Forest LabsArtistic, creative styles, text in images
gpt-image-1OpenAIInstruction-following, editing
nvidia-sanaNVIDIAVery fast, good quality
# Switch to any model — just change the model string
for model in ["truefusion-pro", "flux-2-pro", "google-imagen-4"]:
    prediction = client.predictions.create(
        model=model,
        input={"prompt": "A majestic eagle in flight over mountains"},
    )
    print(f"{model}: {prediction.output[0]}")

Input parameters reference

ParameterTypeDefaultDescription
promptstringrequiredWhat to generate
negative_promptstring""What to avoid
widthint1024Output width (multiples of 8)
heightint1024Output height (multiples of 8)
num_inference_stepsint20Quality: 4 = fast preview, 30 = production
guidance_scalefloat7.0Prompt adherence: 1 = loose, 20 = strict
seedintrandomSet for reproducible outputs
num_outputsint1Generate multiple variations (max: 4)

Reproducibility with seeds

Use seed to get the same image every time with the same prompt:

# Same prompt + same seed = same image
prediction = client.predictions.create(
    model="truefusion-pro",
    input={
        "prompt": "A red fox sitting in autumn leaves",
        "seed": 42,  # Fix this to reproduce exactly
        "width": 1024,
        "height": 1024,
    },
)

Choosing the right model — quick guide

Your situationRecommended model
Building a prototypetruefusion
Production app, defaulttruefusion-pro
Live preview (user is typing)truefusion-edge
Complex scene, text in imagetruefusion-2.0
Maximum photorealismtruefusion-ultra
Artistic / creative outputflux-2-pro
Panoramic / wide-formattruefusion-pano

Summary

  • Start with truefusion-pro — it's right for 80% of use cases
  • truefusion-edge for real-time (sub-2s) — requires Business/Enterprise + Edge API
  • truefusion-2.0 when scene complexity or text accuracy matters
  • Third-party models (FLUX, Imagen, GPT-Image-1) are one model-string change away

Next: prompt engineering — how to write prompts that reliably produce the outputs you want.

On this page