OIP system: ArcAds
ArcAds
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.
This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.
Kind: api. Capabilities: 6. Machine system map: /api/dispatch?map=ARCADS&format=markdown. Root: /a/oip.
Operations
ARCADS_GENERATE
Generate an ad image via ArcAds, poll to completion, store to R2, return a stable link Use when: you need to arcads generate Arguments: model|prompt|aspectRatio|referenceImages|productId|enhance. Human article: /a/oip-capability-arcads-generate. Machine doc: ?key=ARCADS_GENERATE&format=markdown. Invocation history: /api/invocations?object_id=ARCADS_GENERATE.
ARCADS_VIDEO_GENERATE
Generate a video via ArcAds, poll, store to R2, return a stable link Use when: you need to arcads video generate Arguments: model|prompt|aspectRatio|referenceImages|duration|productId. Human article: /a/oip-capability-arcads-video-generate. Machine doc: ?key=ARCADS_VIDEO_GENERATE&format=markdown. Invocation history: /api/invocations?object_id=ARCADS_VIDEO_GENERATE.
ARCADS_UPLOAD
Upload a file to ArcAds (presign + S3 PUT). Returns {filePath,fileId}; pass filePath in referenceImages. fileType e.g. image/png, image/jpeg, video/mp4, audio/mp3 Use when: you need to arcads upload Arguments: source_url|file_type. Human article: /a/oip-capability-arcads-upload. Machine doc: ?key=ARCADS_UPLOAD&format=markdown. Invocation history: /api/invocations?object_id=ARCADS_UPLOAD.
ARCADS_CREDITS
ArcAds credit usage this month. Returns {month,used,cap,remaining}. Cap from settings.arcads_monthly_credits (80440). Logged from each generate (data.creditsCharged) Use when: you need to arcads credits Arguments: none. Human article: /a/oip-capability-arcads-credits. Machine doc: ?key=ARCADS_CREDITS&format=markdown. Invocation history: /api/invocations?object_id=ARCADS_CREDITS.
ARCADS
Invokable OIP capability. Human article: /a/oip-capability-arcads. Machine doc: ?key=ARCADS&format=markdown. Invocation history: /api/invocations?object_id=ARCADS.
ARCADS_ROUTES
ArcAds HTTP unified entrypoint Use when: direct ArcAds REST ops (presigned uploads, products, assets, situations, fields) Arguments: $1=op, $2..$N=positional args. Human article: /a/oip-capability-arcads-routes. Machine doc: ?key=ARCADS_ROUTES&format=markdown. Invocation history: /api/invocations?object_id=ARCADS_ROUTES.