Drops

Say the next thing to a drop

Say the next thing to a drop and get its answer with everything it has made. This is the only verb the drop needs: research, concepts, a storyboard, a board, a render or a scheduled post are all asked for in words, and the engine picks the phase itself. Without a run_id a new drop is started from the message. Asking costs no credits; a step that would charge stops for POST /v1/engine/runs/{id}/approve and shows up as pending_approval. Send Accept: application/json for one settled turn; the default is a stream (see the tag description). A turn that outlives the wait comes back 202 as still working and keeps going; send X-ACD-Wait-Ms to be answered inside your own client's timeout, then follow the drop with GET /v1/engine/runs/{id}.

post/v1/engine/chat

Request

  • Base URL: https://aicontentdrop.com
  • URL: https://aicontentdrop.com/v1/engine/chat
  • Auth: HTTP bearer

Headers

X-ACD-Wait-Msinteger

With Accept: application/json, how long to hold the request for the turn to settle, in milliseconds counted from when the request arrives. Clamped to 5000-110000; without it the route holds a turn for 110 seconds. When the wait ends first the answer is 202 and the turn keeps going; nothing is cancelled. Ignored on a stream.

Request body

run_idstring uuid

The drop to continue. Omit to start a new one from this message.

messagestring required

What you want next, in words.

thinking_mode'normal' | 'deep'

How much effort to spend planning the turn. Depth only — it changes no capability.

approval_mode'confirm_each'

Sets the mode when this call starts a new drop; ignored on an existing one. confirm_each is the only mode today, so omit it.

budget_creditsinteger

Sets the credit ceiling when this call starts a new drop. A step that would pass it stops, and approving cannot lift it.

attachmentsstring[]

Public https URLs of images or clips to work from, at most 8.

mode'proposal' | 'produce'

Recorded when the drop is created and never read from the wire again.

source'url' | 'embed:video-studio' | 'embed:images' | 'embed:marketplace'

Which surface opened the drop. Provenance only; nothing branches on it.

Response

The turn settled. next_step says what to do with what came back.

run_idstring uuid required
phase'intake' | 'research' | 'concept' | 'plan' | 'produce' | 'assemble' | 'distribute' | 'done' required
status'idle' | 'running' | 'waiting_input' | 'waiting_approval' | 'failed' | 'done' | 'cancelled' required
answerstring required

What the drop said back. Empty when the turn outlived its window and was answered 202.

next_stepstring required

What to do next, in plain words, so a caller never has to infer it from the status.

Changes

No recorded changes to this operation across all 1 revision of this API.