Recraft Recraft V3 API | Preise & Docs

recraft/recraft-v3/text-to-image

Generieren Sie Grafiken im Raster- und Vektorstil mit wählbaren Abmessungen, einem umfangreichen Stilkatalog und einer optionalen Palette von bis zu zehn Farben.

Inhaltsverzeichnis

1. Erste Schritte

Nutzen Sie die RunComfy-API, um recraft/recraft-v3/text-to-image auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/recraft/recraft-v3/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
  }'

2. Authentifizierung

Weisen Sie der Umgebungsvariable YOUR_API_TOKEN Ihren API-Schlüssel zu (Verwaltung unter Profil). Senden Sie bei jeder Anfrage im Header Authorization einen Bearer-Token: Authorization: Bearer $YOUR_API_TOKEN.

3. API-Referenz

Anfrage senden

Senden Sie einen asynchronen Generierungsauftrag und erhalten Sie sofort eine request_id sowie URLs für Status, Ergebnisse und Abbruch.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/recraft/recraft-v3/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
  }'

Anfragestatus abrufen

Ruft den aktuellen Status für eine request_id ab („in_queue“, „in_progress“, „completed“ oder „cancelled“).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Ergebnisse abrufen

Ruft die endgültigen Ausgaben und Metadaten für die angegebene request_id ab; ist der Auftrag noch nicht fertig, liefert die Antwort den aktuellen Status zum Weiterpollen.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Anfrage abbrechen

Bricht einen wartenden Auftrag per request_id ab; laufende Aufträge können nicht abgebrochen werden.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Dateieingaben

Gehostete Datei (URL)

Geben Sie eine öffentlich erreichbare HTTPS-URL an. Der Host muss serverseitige Abrufe erlauben (ohne Login/Cookies), nicht drosseln oder Bots blockieren. Empfohlen: Bilder ≤ 50 MB (~4K), Videos ≤ 100 MB (~2–5 Min. bei 720p). Für private Assets stabile oder vorab signierte URLs verwenden.

5. Schema

Eingabeschema

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Erforderlicher Text, der das Thema, die Komposition, den Stil, die Beleuchtung und den zu rendernden Text beschreibt.",
      "type": "string",
      "default": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
    },
    "style": {
      "title": "Stil",
      "description": "Wählen Sie „any“ oder eine Vorgabe aus den Kategorien „realistic_image“, „digital_illustration“ oder „vector_illustration“. Standardmäßig ist „any“ ausgewählt.",
      "type": "string",
      "enum": [
        "any",
        "realistic_image",
        "realistic_image/b_and_w",
        "realistic_image/hard_flash",
        "realistic_image/hdr",
        "realistic_image/natural_light",
        "realistic_image/studio_portrait",
        "realistic_image/enterprise",
        "realistic_image/motion_blur",
        "realistic_image/evening_light",
        "realistic_image/faded_nostalgia",
        "realistic_image/forest_life",
        "realistic_image/mystic_naturalism",
        "realistic_image/natural_tones",
        "realistic_image/organic_calm",
        "realistic_image/real_life_glow",
        "realistic_image/retro_realism",
        "realistic_image/retro_snapshot",
        "realistic_image/urban_drama",
        "realistic_image/village_realism",
        "realistic_image/warm_folk",
        "digital_illustration",
        "digital_illustration/pixel_art",
        "digital_illustration/hand_drawn",
        "digital_illustration/grain",
        "digital_illustration/infantile_sketch",
        "digital_illustration/2d_art_poster",
        "digital_illustration/handmade_3d",
        "digital_illustration/hand_drawn_outline",
        "digital_illustration/engraving_color",
        "digital_illustration/2d_art_poster_2",
        "digital_illustration/antiquarian",
        "digital_illustration/bold_fantasy",
        "digital_illustration/child_book",
        "digital_illustration/child_books",
        "digital_illustration/cover",
        "digital_illustration/crosshatch",
        "digital_illustration/digital_engraving",
        "digital_illustration/expressionism",
        "digital_illustration/freehand_details",
        "digital_illustration/grain_20",
        "digital_illustration/graphic_intensity",
        "digital_illustration/hard_comics",
        "digital_illustration/long_shadow",
        "digital_illustration/modern_folk",
        "digital_illustration/multicolor",
        "digital_illustration/neon_calm",
        "digital_illustration/noir",
        "digital_illustration/nostalgic_pastel",
        "digital_illustration/outline_details",
        "digital_illustration/pastel_gradient",
        "digital_illustration/pastel_sketch",
        "digital_illustration/pop_art",
        "digital_illustration/pop_renaissance",
        "digital_illustration/street_art",
        "digital_illustration/tablet_sketch",
        "digital_illustration/urban_glow",
        "digital_illustration/urban_sketching",
        "digital_illustration/vanilla_dreams",
        "digital_illustration/young_adult_book",
        "digital_illustration/young_adult_book_2",
        "vector_illustration",
        "vector_illustration/bold_stroke",
        "vector_illustration/chemistry",
        "vector_illustration/colored_stencil",
        "vector_illustration/contour_pop_art",
        "vector_illustration/cosmics",
        "vector_illustration/cutout",
        "vector_illustration/depressive",
        "vector_illustration/editorial",
        "vector_illustration/emotional_flat",
        "vector_illustration/infographical",
        "vector_illustration/marker_outline",
        "vector_illustration/mosaic",
        "vector_illustration/naivector",
        "vector_illustration/roundish_flat",
        "vector_illustration/segmented_colors",
        "vector_illustration/sharp_contrast",
        "vector_illustration/thin",
        "vector_illustration/vector_photo",
        "vector_illustration/vivid_shapes",
        "vector_illustration/engraving",
        "vector_illustration/line_art",
        "vector_illustration/line_circuit",
        "vector_illustration/linocut"
      ],
      "default": "any"
    },
    "image_size": {
      "title": "Bildgröße (B:H)",
      "description": "Wählen Sie eine der fünfzehn aufgelisteten Ausgabeabmessungen und Seitenverhältnisse; Standard: 1024:1024 (1:1).",
      "type": "string",
      "enum": [
        "2048:1024 (2:1)",
        "1820:1024 (16:9)",
        "1707:1024 (5:3)",
        "1536:1024 (3:2)",
        "1434:1024 (7:5)",
        "1365:1024 (4:3)",
        "1280:1024 (5:4)",
        "1024:1024 (1:1)",
        "1024:1280 (4:5)",
        "1024:1365 (3:4)",
        "1024:1434 (5:7)",
        "1024:1536 (2:3)",
        "1024:1707 (3:5)",
        "1024:1820 (9:16)",
        "1024:2048 (1:2)"
      ],
      "default": "1024:1024 (1:1)"
    },
    "colors": {
      "title": "Bevorzugte Farben",
      "description": "Optionale Liste mit bis zu zehn RGB-Farben als Vorgabe für die generierte Palette; die Standardliste enthält 192_158_255.",
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 0,
      "default": [
        "192_158_255"
      ]
    }
  }
}

Ausgabeschema

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "Einzelbild-URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "Einzelvideo-URL"
      },
      "images": {
        "type": "array",
        "description": "mehrere Bild-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "mehrere Video-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy ist die führende ComfyUI Plattform, die ComfyUI online Umgebung und Services bietet, zusammen mit ComfyUI Workflows mit atemberaubenden Visualisierungen. RunComfy bietet auch AI Models, Künstlern ermöglichen, die neuesten AI-Tools zu nutzen, um unglaubliche Kunst zu schaffen.

1. Erste Schritte

Nutzen Sie die RunComfy-API, um recraft/recraft-v3/text-to-image auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/recraft/recraft-v3/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
  }'

3. API-Referenz

Anfrage senden

Senden Sie einen asynchronen Generierungsauftrag und erhalten Sie sofort eine request_id sowie URLs für Status, Ergebnisse und Abbruch.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/recraft/recraft-v3/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
  }'

Anfragestatus abrufen

Ruft den aktuellen Status für eine request_id ab („in_queue“, „in_progress“, „completed“ oder „cancelled“).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Ergebnisse abrufen

Ruft die endgültigen Ausgaben und Metadaten für die angegebene request_id ab; ist der Auftrag noch nicht fertig, liefert die Antwort den aktuellen Status zum Weiterpollen.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Anfrage abbrechen

Bricht einen wartenden Auftrag per request_id ab; laufende Aufträge können nicht abgebrochen werden.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Dateieingaben

Gehostete Datei (URL)

5. Schema

Eingabeschema

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Erforderlicher Text, der das Thema, die Komposition, den Stil, die Beleuchtung und den zu rendernden Text beschreibt.",
      "type": "string",
      "default": "A surreal circus tent with velvet walls shimmering under moonlight. Ethereal performers float on glowing trapezes, while the ground is covered in golden dust. The dark teal and burgundy tones create a luxurious yet mysterious atmosphere."
    },
    "style": {
      "title": "Stil",
      "description": "Wählen Sie „any“ oder eine Vorgabe aus den Kategorien „realistic_image“, „digital_illustration“ oder „vector_illustration“. Standardmäßig ist „any“ ausgewählt.",
      "type": "string",
      "enum": [
        "any",
        "realistic_image",
        "realistic_image/b_and_w",
        "realistic_image/hard_flash",
        "realistic_image/hdr",
        "realistic_image/natural_light",
        "realistic_image/studio_portrait",
        "realistic_image/enterprise",
        "realistic_image/motion_blur",
        "realistic_image/evening_light",
        "realistic_image/faded_nostalgia",
        "realistic_image/forest_life",
        "realistic_image/mystic_naturalism",
        "realistic_image/natural_tones",
        "realistic_image/organic_calm",
        "realistic_image/real_life_glow",
        "realistic_image/retro_realism",
        "realistic_image/retro_snapshot",
        "realistic_image/urban_drama",
        "realistic_image/village_realism",
        "realistic_image/warm_folk",
        "digital_illustration",
        "digital_illustration/pixel_art",
        "digital_illustration/hand_drawn",
        "digital_illustration/grain",
        "digital_illustration/infantile_sketch",
        "digital_illustration/2d_art_poster",
        "digital_illustration/handmade_3d",
        "digital_illustration/hand_drawn_outline",
        "digital_illustration/engraving_color",
        "digital_illustration/2d_art_poster_2",
        "digital_illustration/antiquarian",
        "digital_illustration/bold_fantasy",
        "digital_illustration/child_book",
        "digital_illustration/child_books",
        "digital_illustration/cover",
        "digital_illustration/crosshatch",
        "digital_illustration/digital_engraving",
        "digital_illustration/expressionism",
        "digital_illustration/freehand_details",
        "digital_illustration/grain_20",
        "digital_illustration/graphic_intensity",
        "digital_illustration/hard_comics",
        "digital_illustration/long_shadow",
        "digital_illustration/modern_folk",
        "digital_illustration/multicolor",
        "digital_illustration/neon_calm",
        "digital_illustration/noir",
        "digital_illustration/nostalgic_pastel",
        "digital_illustration/outline_details",
        "digital_illustration/pastel_gradient",
        "digital_illustration/pastel_sketch",
        "digital_illustration/pop_art",
        "digital_illustration/pop_renaissance",
        "digital_illustration/street_art",
        "digital_illustration/tablet_sketch",
        "digital_illustration/urban_glow",
        "digital_illustration/urban_sketching",
        "digital_illustration/vanilla_dreams",
        "digital_illustration/young_adult_book",
        "digital_illustration/young_adult_book_2",
        "vector_illustration",
        "vector_illustration/bold_stroke",
        "vector_illustration/chemistry",
        "vector_illustration/colored_stencil",
        "vector_illustration/contour_pop_art",
        "vector_illustration/cosmics",
        "vector_illustration/cutout",
        "vector_illustration/depressive",
        "vector_illustration/editorial",
        "vector_illustration/emotional_flat",
        "vector_illustration/infographical",
        "vector_illustration/marker_outline",
        "vector_illustration/mosaic",
        "vector_illustration/naivector",
        "vector_illustration/roundish_flat",
        "vector_illustration/segmented_colors",
        "vector_illustration/sharp_contrast",
        "vector_illustration/thin",
        "vector_illustration/vector_photo",
        "vector_illustration/vivid_shapes",
        "vector_illustration/engraving",
        "vector_illustration/line_art",
        "vector_illustration/line_circuit",
        "vector_illustration/linocut"
      ],
      "default": "any"
    },
    "image_size": {
      "title": "Bildgröße (B:H)",
      "description": "Wählen Sie eine der fünfzehn aufgelisteten Ausgabeabmessungen und Seitenverhältnisse; Standard: 1024:1024 (1:1).",
      "type": "string",
      "enum": [
        "2048:1024 (2:1)",
        "1820:1024 (16:9)",
        "1707:1024 (5:3)",
        "1536:1024 (3:2)",
        "1434:1024 (7:5)",
        "1365:1024 (4:3)",
        "1280:1024 (5:4)",
        "1024:1024 (1:1)",
        "1024:1280 (4:5)",
        "1024:1365 (3:4)",
        "1024:1434 (5:7)",
        "1024:1536 (2:3)",
        "1024:1707 (3:5)",
        "1024:1820 (9:16)",
        "1024:2048 (1:2)"
      ],
      "default": "1024:1024 (1:1)"
    },
    "colors": {
      "title": "Bevorzugte Farben",
      "description": "Optionale Liste mit bis zu zehn RGB-Farben als Vorgabe für die generierte Palette; die Standardliste enthält 192_158_255.",
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 0,
      "default": [
        "192_158_255"
      ]
    }
  }
}

Ausgabeschema

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "Einzelbild-URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "Einzelvideo-URL"
      },
      "images": {
        "type": "array",
        "description": "mehrere Bild-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "mehrere Video-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Recraft V3: Text-zu-Bild-Generator | RunComfy

Generieren Sie Grafiken im Raster- und Vektorstil mit wählbaren Abmessungen, einem umfangreichen Stilkatalog und einer optionalen Palette von bis zu zehn Farben.

Inhaltsverzeichnis

1. Erste Schritte

2. Authentifizierung

3. API-Referenz

Anfrage senden

Anfragestatus abrufen

Ergebnisse abrufen

Anfrage abbrechen

4. Dateieingaben

Gehostete Datei (URL)

5. Schema

Eingabeschema

Ausgabeschema

Recraft V3: Text-zu-Bild-Generator | RunComfy

Generieren Sie Grafiken im Raster- und Vektorstil mit wählbaren Abmessungen, einem umfangreichen Stilkatalog und einer optionalen Palette von bis zu zehn Farben.

Inhaltsverzeichnis

1. Erste Schritte

2. Authentifizierung

3. API-Referenz

Anfrage senden

Anfragestatus abrufen

Ergebnisse abrufen

Anfrage abbrechen

4. Dateieingaben

Gehostete Datei (URL)

5. Schema

Eingabeschema

Ausgabeschema