Skip to main content

​
Overview

Agent Skills are short instruction files your coding agent loads while it writes a 9Pic integration. Install them into Cursor, Claude Code, Codex, or any other tool that supports the skills CLI. Each skill names the API Reference pages for that job. The API key stays on your backend, FaceFind searches reuse one request_id, and guests see watermarked previews until you unlock originals.

API Skill

API keys, identifiers, the response envelope, pagination, and errors.

Participant App

FaceFind, BibTrack, gallery, Motion clips, and watermarked previews.

Media Selling

Your checkout, then original photos after a confirmed sale.

​
Install

1

Create an API key

Create a token in Developer Zone. Developer Zone is Enterprise only. Send the key as X-API-Key as described in Authentication.
2

Install the skills

From the repository where the agent will write code:
That installs every 9Pic skill. To install one:
3

Describe the integration

Tell the agent what you are building: a guest gallery, selfie search, bib search, clips, or paid originals. Paths, fields, and examples come from the linked API Reference pages.
Installed skills do not update on their own. After we publish a change, run npx skills update -y or re-run the add command.
If the npx skills CLI is not available, the discovery index is at https://docs.9pic.ai/.well-known/skills/index.json.
Agents that fetch 9pic.ai/llms.txt get a short product brief and the same install command. The install guide walks through the CLI.
Treat the API key as a server secret. Send X-API-Key only from your backend. Do not put the token in client-side code, a mobile binary, or a public repository.

​
Common Questions

Install all three if you are unsure. Use API Skill for any call to api.9pic.ai. Add Participant App for a guest-facing gallery or search. Add Media Selling when you take payment yourself and then unlock originals.
Yes. Paths, request bodies, pagination limits, and response shapes live in the API Reference. Skills point the agent at those pages.
Yes. Guests see thumbnails and watermarked images until you record a successful sale. Your backend then calls Download Originals. See Media Selling.
No. Those are organiser pipeline endpoints. Start from Memories if you need them.

​
Next Steps

Authentication

Create a token and send X-API-Key.

API Reference

Endpoints, conventions, models, and errors.

Developer Zone

Where Enterprise organisations create API keys.

Conventions

Base URL, identifiers, envelope, and pagination.