Source: https://docs.sogni.ai/agents/

# Use Sogni with your AI agent

Sogni gives your agent image generation and editing, video, music, and durable creative workflows on the Sogni Supernet. Use the Creative Agent Skill in a terminal agent, the local MCP extension in Claude Desktop, or the REST API in your own application.

## [#](https://docs.sogni.ai/agents/#get-your-first-result)Get your first result

1.  [Install and check access](https://docs.sogni.ai/agents/first-result/). You need a Sogni account and an API key, plus funding or subscription coverage for your chosen model.
2.  [Check models and cost](https://docs.sogni.ai/agents/pricing/). A model being listed does not mean your account can use it with free Spark.
3.  Submit one image and keep the result. For longer work, [save the durable job handle](https://docs.sogni.ai/agents/jobs/) so your agent can recover after a disconnect.

Prefer a browser? [Open Sogni Chat](https://chat.sogni.ai/?source=agent-docs) to create without installing a local runtime.

## [#](https://docs.sogni.ai/agents/#choose-your-integration)Choose your integration

| Where your agent runs | Setup |
| --- | --- |
| Claude Code | [Skill and plugin installation](https://docs.sogni.ai/sogni-intelligence/creative-agent-skill/#claude-code) |
| Codex | [Skill and local MCP installation](https://docs.sogni.ai/sogni-intelligence/creative-agent-skill/#openai-codex) |
| Hermes Agent | [Hermes integration guide](https://docs.sogni.ai/sogni-intelligence/integration-hermes-agent/) |
| Claude Desktop | [Local MCP extension](https://docs.sogni.ai/sogni-intelligence/creative-agent-skill/#claude-desktop) |
| Your application | [REST API reference](https://docs.sogni.ai/api-reference/) and [SDK](https://docs.sogni.ai/sogni-sdk/) |

The local MCP extension runs on your computer. A public hosted MCP connection, delegated account authorization, and agent-initiated card purchases are not part of this setup guide (as of September 2026).

## [#](https://docs.sogni.ai/agents/#find-the-contract-you-need)Find the contract you need

| Task | Documentation |
| --- | --- |
| Sign in, configure or replace a key | [Authentication](https://docs.sogni.ai/agents/authentication/) |
| Select a current model and its inputs | [Model discovery](https://docs.sogni.ai/api-reference/model-discovery/), [model catalog](https://docs.sogni.ai/models/) |
| Understand free Spark, paid Spark and budgets | [Pricing and funding](https://docs.sogni.ai/agents/pricing/) |
| Submit, resume, cancel and download | [Jobs and assets](https://docs.sogni.ai/agents/jobs/) |
| Handle API failures | [Errors](https://docs.sogni.ai/api-reference/getting-started/#errors) |
| Use the full CLI | [Creative Agent Skill](https://docs.sogni.ai/sogni-intelligence/creative-agent-skill/) |
| Read this site as an agent | Use each page's **Markdown** link, for example [this page](https://docs.sogni.ai/agents/index.md). API exports include endpoint details and every code tab. |

## [#](https://docs.sogni.ai/agents/#trust-and-support)Trust and support

The official publisher is [Sogni AI on GitHub](https://github.com/Sogni-AI). Check the [service status](https://status.sogni.ai/), [privacy policy](https://www.sogni.ai/privacy-policy), [terms](https://www.sogni.ai/terms-of-service), and [cancellation and refund policy](https://docs.sogni.ai/pricing/cancellation-and-refund-policy/). For help, use [Sogni Discord](https://discord.gg/sogni-ai).

Never put API keys, payment credentials or private reference media in a public issue. An estimate or a successful installation check is not proof of a completed render.