---
title: "Run External Neo Inference V2"
method: POST
path: "/inferences"
tags: ["external-inference-v2"]
---

# Run External Neo Inference V2

`POST /inferences`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/inferences`
- Auth: none declared. Required headers: `X-RD-Token`

Always admit inference asynchronously; cost checks stay immediate.

## Headers

- `X-RD-Token` string, required
- `X-RD-Fail-Inference` string
- `X-RD-Billing-Canary-Fault` 'normal_failure' | 'stale_reconciliation': An enumeration.
- `Idempotency-Key` string: Optional token-scoped key; reuse for retries of the same inference inputs.

## Request body

- ExternalInferenceInputNeo
  - `prompt` string
  - `extra_prompt` string
  - `negative` string
  - `width` integer, required
  - `height` integer, required
  - `model` 'RD_CLASSIC' | 'RD_FLUX': An enumeration.
  - `num_images` integer, required
  - `seed` integer
  - `prompt_style` string
  - `strength` number
  - `extra_strength` number
  - `frames_duration` integer
  - `tile_x` boolean
  - `tile_y` boolean
  - `input_image` string
  - `input_palette` string
  - `extra_input_image` string
  - `reference_images` string[]
  - `upscale_output_factor` integer
  - `upload_outputs` boolean
  - `output_bg_color` string
  - `remove_bg` boolean
  - `return_spritesheet` boolean
  - `return_non_bg_removed` boolean
  - `return_pre_palette` boolean
  - `bypass_prompt_expansion` boolean
  - `check_cost` boolean
  - `include_downloadable_data` boolean
  - `include_extra_data` boolean
  - `async` boolean
  - `async_process` boolean

## Response `200`

Successful Response

- union
  - InferenceRun (unresolved $ref)
  - ExternalInferenceTaskAccepted
    - `status` 'accepted', required
    - `task_id` string, required
    - `request_id` string
    - `message` string, required

## Other responses

- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Unexpected internal error.

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)