## Basic tool info

Tool name: andreac75/3D-Caricature
Tool description: 3D Caricature

Tool cover: https://cdn.wiro.ai/uploads/models/andreac75-3D-Caricature-cover.jpeg
Tool categories:
  - model
  - text-to-image
  - checkpoint-file
  - lora-flux
  - bf16
  - persistent

Tool tags:
  - style

Run Task Endpoint (POST):
https://api.wiro.ai/v1/Run/andreac75/3D-Caricature

Get Task Detail Endpoint (POST):
https://api.wiro.ai/v1/Task/Detail

## Tool Inputs: 

  - name: prompt
    label: prompt
    help: prompt-help
    type: textarea
    default: 3dc4r1c4t9r3a a man in a pub

  - name: samples
    label: numberofoutputs
    help: numberofoutputs-help
    type: number
    default: 1

  - name: steps
    label: inferencesteps
    help: inferencesteps-help
    type: number
    default: 20

  - name: scale
    label: guidancescale
    help: guidancescale-help
    type: float
    default: 3.8

  - name: seed
    label: seed
    help: seed-help
    type: text
    default: 123456

  - name: width
    label: width
    help: width-help
    type: number
    default: 1024

  - name: height
    label: height
    help: height-help
    type: number
    default: 1024



## Tool Parameter Inspires:

  - seed: 29952364
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a a man in a pub

  - seed: 14077215
  - scale: 3
  - steps: 24
  - prompt: 3dc4r1c4t9r3a   a yellow blue whale swimming through the dessert

  - seed: 19320661
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a  A starship captain in a sleek uniform standing on the bridge of a futuristic spacecraft,surrounded by glowing control panels, a vast starfield visible through a massive window, cinematic lighting, highly detailed character design

  - seed: 21439319
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a  a man in a top hat and glasses smiling and looking at the camera, sitting at a bar. He is wearing a black blazer, and frames on the wall. To the left of the image is a window., 3dc4r1c4t9r3 a cat sitting in the middle of a garden surrounded by plants and trees

  - seed: 41781682
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a skeleton cowboy pointing a gun to the viewer

  - seed: 34920007
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a   a woman in a Hero dress standing next to a dragon in a grassy landscape with trees in the background

  - seed: 36973006
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a  A space pirate queen smiling and  wearing a crown made of starlight crystals,her armor glowing faintly as if charged by cosmic energy.

  - seed: 84815137
  - scale: 1
  - steps: 10
  - prompt: 3dc4r1c4t9r3a, A beautiful female electric violinist, wearing pink dress,  alone in a big desert Italian place.  Everything else in the image is black and white, including the background and architectural elements.Spotlight on the violinist, Engrossed crowd, High contrast, Intricate violin details, Dynamic performance pose. diclrpp

  - seed: 42521168
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a   a woman in a Hero dress standing next to a dragon in a grassy landscape with trees in the background

  - seed: 25678855
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a  A woman with long,flowing hair made of stars holding a glowing glass orb in her hands

  - seed: 47851839
  - scale: 3.5
  - steps: 22
  - prompt: 3dc4r1c4t9r3a This is a digital artwork featuring a stylized,surreal depiction of a figure in an urban environment. The subject is a person wearing a hooded jacket, the hood pulled up, obscuring their face. The figure's head and face are rendered in a dark, featureless silhouette, except for the eyes, which are glowing bright ruby-red. These glowing eyes are the only visible features, giving the figure an eerie, otherworldly appearance.

  - seed: 14354102
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a A beautiful witch making a potion

  - seed: 28775410
  - scale: 3.5
  - steps: 50
  - prompt: 3dc4r1c4t9r3a   Neon Orange animal Monster huge chibi eyes pink dots fur and duck feet with large fangs, Horns, claws, jumping towards viewer, having fun.

  - seed: 38970157
  - scale: 1
  - steps: 25
  - prompt: 3dc4r1c4t9r3a  A fluffy bunny with tiny,adorable fangs, wearing a red bowtie and sitting beside a small basket of candy. The bunny’s ears are slightly flopped, Sweet and playful

  - seed: 42949672
  - scale: 3
  - steps: 28
  - prompt: 3dc4r1c4t9r3a, a smiling happy HarryBigfoot the friendly sasquatch is running in a marathon, wearing vintage running gear, like tight red shorts, a white tank top and a multicolored headband. The starting number ”1337” is his bib number. NYC in the background, with exhausted runners dripping with sweat

  - seed: 20987374
  - scale: 3.5
  - steps: 50
  - prompt: 3dc4r1c4t9r3a huge bronto saurus skating on inline-skate,wearing a pink tutu

  - seed: 84815137
  - scale: 1
  - steps: 10
  - prompt: 3dc4r1c4t9r3a, A beautiful female electric violinist, wearing yellow semitransparent dress,  alone in a big desert Italian place.  Everything else in the image is black and white, including the background and architectural elements.Spotlight on the violinist, Engrossed crowd, High contrast, Intricate violin details, Dynamic performance pose. diclrpp

  - seed: 84815137
  - scale: 1
  - steps: 10
  - prompt: 3dc4r1c4t9r3a, A beautiful female electric violinist, wearing green dress,  alone in a big desert Italian place.  Everything else in the image is black and white, including the background and architectural elements.Spotlight on the violinist, Engrossed crowd, High contrast, Intricate violin details, Dynamic performance pose. diclrpp

  - seed: 12360924
  - scale: 3.5
  - steps: 24
  - prompt: 3dc4r1c4t9r3a  a Fluffy cute cat sitting on a buildings roof. Looking at viewer with an evil mischievious smile, white sharp teeth, pressing with one paw on a big Red Button on a black Controller Box in Front of the cat. Paw on Red Button, pressing the Red Button with paw.There is explosion of fire in the distance from the city below. The sky is a mixture of red and black. Very detailed. Vibrant colors.

  - seed: 29658819
  - scale: 1
  - steps: 20
  - prompt: 3dc4r1c4t9r3a  of a moroccan snake charmer is sitting on the floor of an colorful market place playing the flute and in front of him a mighty snake is dancing.  The snake charmer is surrounded by an magical and whimsical atmosphere with light particles in a denim blue  theme  
  - negativePrompt: multible snake tails, bad anatomy, bad hands, bad feet,

  - seed: 74845049
  - scale: 3.5
  - steps: 24
  - prompt: 3dc4r1c4t9r3a  a Fluffy cute cat sitting on a buildings roof. Looking at viewer with an evil mischievious smile, white sharp teeth, pressing with one paw on a big Red Button on a black Controller Box in Front of the cat. Paw on Red Button, pressing the Red Button with paw.There is explosion of fire in the distance from the city below. The sky is a mixture of red and black. Very detailed. Vibrant colors.

  - seed: 17281573
  - scale: 3.5
  - steps: 22
  - prompt: 3dc4r1c4t9r3a Two Samurai charge towards each other across a misty battlefield,their footsteps echoing on the silent earth. Swords raised high, they move with deadly precision, the tension palpable. As they near, the air crackles with the weight of impending battle. In a flash, steel meets steel, sparks flying as their blades clash in a fierce, synchronized dance of life and death.

  - seed: 84543876
  - scale: 3.5
  - steps: 40
  - prompt: 3dc4r1c4t9r3a two Samurai running towards each other with raised swords,edo backgrounf

  - seed: 36000496
  - scale: 3.5
  - steps: 24
  - prompt: 3dc4r1c4t9r3a  an elephant rampaging through a porcelain shop

  - seed: 39479457
  - scale: 1
  - steps: 20
  - prompt: 3dc4r1c4t9r3a  of a moroccan snake charmer is sitting on the floor of an colorful market place playing the flute and in front of him a mighty snake is dancing.  The snake charmer is surrounded by an magical and whimsical atmosphere with light particles in a auburn  theme  
  - negativePrompt: multible snake tails, bad anatomy, bad hands, bad feet,

  - seed: 40405102
  - scale: 3.5
  - steps: 24
  - prompt: 3dc4r1c4t9r3a  a pink elephant with green spots rampaging through a brititsh porcelain shop

  - seed: 31093944
  - scale: 1
  - steps: 20
  - prompt: create a photograph inspired by the phrase 'forms of feeling' 

  - seed: 79601129
  - scale: 1
  - steps: 20
  - prompt: create a photograph inspired by the phrase 'forms of feeling' 

  - seed: 31093944
  - scale: 1
  - steps: 20
  - prompt: create a photograph inspired by the phrase 'forms of feeling' 

  - seed: 30833800
  - scale: 1
  - steps: 30
  - prompt:  3dc4r1c4t9r3a superman sporting a huge grin showing perfect white teeth standing hands on hips posing

  - seed: 70679027
  - steps: 10
  - prompt: The cockatoo is depicted with striking white feathers, a bold red crest that stands upright on its head, and an orange beak. The bird's eyes are dark and round, set against the bright plumage. Its body is medium-sized, with a rounded head and a sturdy build, creating a visually balanced form. The arrangement of the crest feathers adds depth to the 3D appearance, emphasizing texture and contrast in colors.

  - seed: 31093944
  - scale: 1
  - steps: 20
  - prompt: create a photograph inspired by the phrase 'forms of feeling' 



## Integration Header Prepare 
```bash
  # Sign up Wiro dashboard and create project
  export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; 
  export YOUR_API_SECRET="XXXXXXXXX"; 

  # unix time or any random integer value
  export NONCE=$(date +%s);

  # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY
  export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")";
```

## Run Command - Make HTTP Post Request 
```bash
curl -X POST "https://api.wiro.ai/v1/Run/andreac75/3D-Caricature" 
-H "Content-Type: multipart/form-data" 
-H "x-api-key: ${YOUR_API_KEY}" 
-H "x-nonce: ${NONCE}" 
-H "x-signature: ${SIGNATURE}" 
-d '{
  "prompt": "3dc4r1c4t9r3a a man in a pub",
  "samples": 1,
  "steps": 20,
  "scale": "3.8",
  "seed": "123456",
  "width": 1024,
  "height": 1024,
  "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed."
}';
```


## Run Command - Response
```json
{
    "errors": [],
    "taskid": "2221",
    "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt",
    "result": true
}
```


## Get Task Detail - Make HTTP Post Request
```bash
curl -X POST "https://api.wiro.ai/v1/Task/Detail"  
-H "Content-Type: multipart/form-data" 
-H "x-api-key: ${YOUR_API_KEY}" 
-H "x-nonce: ${NONCE}" 
-H "x-signature: ${SIGNATURE}" 
-d '{
  "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt',
}';
```

## Get Task Detail - Response
```json
{
  "total": "1",
  "errors": [],
  "tasklist": [
      {
          "id": "2221",
          "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd",
          "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt",
          "parameters": {},
          "debugoutput": "",
          "debugerror": "",
          "starttime": "1734513809",
          "endtime": "1734513813",
          "elapsedseconds": "6.0000",
          "status": "task_postprocess_end",
          "createtime": "1734513807",
          "canceltime": "0",
          "assigntime": "1734513807",
          "accepttime": "1734513807",
          "preprocessstarttime": "1734513807",
          "preprocessendtime": "1734513807",
          "postprocessstarttime": "1734513813",
          "postprocessendtime": "1734513814",
          "outputs": [
              {
                  "id": "6bc392c93856dfce3a7d1b4261e15af3",
                  "name": "0.png",
                  "contenttype": "image/png",
                  "parentid": "6c1833f39da71e6175bf292b18779baf",
                  "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd",
                  "size": "202472",
                  "addedtime": "1734513812",
                  "modifiedtime": "1734513812",
                  "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK",
                  "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png"
              }
          ],
          "size": "202472"
          }
      ],
  "result": true
}
```


## Task Status Information
This section defines the possible task status values returned by the API when polling for task completion.

### Completed Task Statuses (Polling can stop)
These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop.
- task_postprocess_end : Task completed successfully and post-processing is done.
- task_cancel : Task was cancelled by the user or system.

### Running Task Statuses (Continue polling)
These statuses indicate that the task is still in progress. Polling should continue if one of these is returned.
- task_queue : Task is waiting in the queue.
- task_accept : Task has been accepted for processing.
- task_assign : Task is being assigned to a worker.
- task_preprocess_start : Preprocessing is starting.
- task_preprocess_end : Preprocessing is complete.
- task_start : Task execution has started.
- task_output : Output is being generated.