deAPI image & video generation backends for Hermes Agent — cheap, hosted open-source models as a drop-in alternative to FAL.

• Image: FLUX.2 Klein from ~$0.002/image (512px), FLUX.1 schnell, Z-Image Turbo and more — auto-discovered live, nothing hardcoded
• Video: LTX family text-to-video and image-to-video from ~$0.002/clip
• Free $5 signup credit at app.deapi.ai, no card required
• Pure-Python stdlib, zero dependencies, zero Hermes core changes

Ships as a standalone plugin repo per the Hermes contributing policy for third-party product integrations.

This repo bundles two plugins — deapi-image and deapi-video. Install each one (both share the same DEAPI_API_KEY):

hermes plugins install deapi-ai/hermes-plugin-deapi/deapi-image --enable
hermes plugins install deapi-ai/hermes-plugin-deapi/deapi-video --enable

Or manually (equivalent):

git clone https://github.com/deapi-ai/hermes-plugin-deapi.git /tmp/hpd
mkdir -p ~/.hermes/plugins
cp -r /tmp/hpd/deapi-image ~/.hermes/plugins/deapi-image
cp -r /tmp/hpd/deapi-video ~/.hermes/plugins/deapi-video
hermes plugins enable deapi-image
hermes plugins enable deapi-video

Note: hermes plugins install deapi-ai/hermes-plugin-deapi (repo root, no subdirectory) does not work — the repo root is not itself a plugin. Install the two subdirectories above. Each registers a provider named deapi in the image / video registry respectively.

1. Get an API key at app.deapi.ai and put it in ~/.hermes/.env:

   DEAPI_API_KEY=your-key-here
   

   (Both the raw panel format 12345|... and the dpn-sk--prefixed form work.)

2. Select deAPI as the backend — either via hermes tools → Image/Video Generation (deAPI appears in the picker automatically), or directly in ~/.hermes/config.yaml:

   image_gen:
     provider: deapi
     # model: Flux_2_Klein_4B_BF16   # optional; default = best live Klein/FLUX
   video_gen:
     provider: deapi
     # model: Ltxv_13B_0_9_8_Distilled_FP8

3. Start a new Hermes session and ask: "generate an image of a red fox in snow" or "animate this photo".

Model overrides: image_gen.model / video_gen.model in config, or DEAPI_IMAGE_MODEL / DEAPI_VIDEO_MODEL env vars. Available models are fetched live from GET /api/v2/models — run hermes tools to browse them.

Paste this to your Hermes (or any agent with a terminal):

Install the deAPI image/video plugin for Hermes: clone https://github.com/deapi-ai/hermes-plugin-deapi.git, copy image_gen/deapi to ~/.hermes/plugins/image_gen/deapi and video_gen/deapi to ~/.hermes/plugins/video_gen/deapi, run hermes plugins enable image_gen/deapi and hermes plugins enable video_gen/deapi, add image_gen.provider: deapi and video_gen.provider: deapi to ~/.hermes/config.yaml, and make sure DEAPI_API_KEY is set in ~/.hermes/.env.

Both providers call the native deAPI v2 REST API (api.deapi.ai): submit a job, poll GET /api/v2/jobs/{id}, download the result into Hermes' local cache (~/.hermes/cache/images|videos/) — result URLs expire after ~24 h, so files are persisted immediately. Model parameters (steps, guidance, fps, frame limits) come from each model's live metadata, never hardcoded.

Exact prices: POST /api/v2/<endpoint>/price or deapi.ai/pricing.

• deAPI Agent Skill (portable, agentskills.io): https://github.com/deapi-ai/skills
• deAPI MCP server: https://github.com/deapi-ai/mcp-server-deapi
• deAPI docs: https://docs.deapi.ai

MIT