88API Image Studio for DeepSeek Harness
中文 | English
One image studio replaces separate Image2 and Nano Banana plugins. Generate and edit images in DSH with six 88api.ai models, text-to-image, ordered multi-reference editing, 2K/4K output, sequential batches, and a persistent default model—all behind one Key and one install.
88API Image Studio exposes three model-facing tools:
image_generate_88api generates or edits images.image_model_88api lists models, reads the current default, or changes that default after an explicit user request.image_key_88api inspects, saves, or clears the Key when a user explicitly asks the Agent to configure it.
The plugin follows the current DSH/Cordis bundle contract. It does not depend on the draft Community Fabric manifest.
Models and routing
| Model | Family | Protocol | Resolution |
|---|
gpt-image-2 | Image2 | OpenAI Images API | fixed 2K |
gpt-image-2-4k | Image2 | OpenAI Images API | fixed 4K |
gpt-image-2.5-flare | Image 2.5 | OpenAI Images API | plugin 2K preset |
gpt-image-2.5-sunburst | Image 2.5 | OpenAI Images API | plugin 2K preset |
gemini-3.1-flash-image | Nano Banana | OpenAI Chat Completions | 1K / 2K / 4K |
gemini-3-pro-image | Nano Banana | OpenAI Chat Completions | 1K / 2K / 4K |
The two Image 2.5 IDs and Images API route were verified against the 88API live catalog on 2026-09-10. They reuse the plugin 2K size presets; this is not an upstream resolution limit. Select either exact ID for one call or save it as your default.
The factory default is gpt-image-2. A saved user default overrides it. A model supplied for one generation overrides the default only for that call. The plugin never silently switches models, providers, or protocols.
Install
Install from GitHub into the profile you actually use:
dsh plugin --profile web add github:blackdm666/dsh-plugin-88api-image
For DSH Desktop, replace web with the active Desktop profile name when needed. For reproducible installations, pin a reviewed commit:
dsh plugin --profile web add github:blackdm666/dsh-plugin-88api-image#<commit-sha>
This repository ships runnable JavaScript, so a GitHub install does not need a prepare build or pnpm allowBuilds permission.
Verify the bundle layer before booting:
dsh --profile web --dump-config
The dump should contain the 88api-image row.
Configure the Key: recommended safe method
Run this complete command:
dsh plugin --profile web exec 88api-image set-key
Do not paste the Key yet and do not replace any command text. This complete command only opens Key setup; no part of it is the Key.
Follow these steps in order:
- Run the complete
dsh plugin --profile web exec 88api-image set-key command unchanged, then press Enter once.
- Wait for the terminal to display
88API Key: on a separate line.
- Only then paste the real Key and press Enter again. Hidden input is expected.
dsh plugin invokes plugin management, --profile web selects the profile, exec runs an installed command, 88api-image is this plugin's CLI, and set-key enters Key setup mode. Replace only web when a different profile is active; never replace 88api-image, set-key, or another command part with the Key.
After running it, the terminal displays 88API Key:. Paste the real Key only at that prompt and press Enter. Input is hidden and the complete Key does not enter the command-line arguments.
For non-interactive setup, pipe the Key through standard input:
printf '%s' "$API88_KEY" | dsh plugin --profile web exec 88api-image set-key --stdin
Inspect the masked configuration:
dsh plugin --profile web exec 88api-image config
The default config file is ~/.dsh/88api-image/config.json. API88_KEY overrides the saved Key without writing it to disk. Never commit, paste into an issue, or pass a real Key as a command-line argument.
Configure the Key: ask the Agent to do it
A beginner may say:
My 88API Key is <paste the real Key here>. Save it with image_key_88api. Do not repeat the complete Key; report only the masked preview and whether setup succeeded.
The Agent calls image_key_88api with action=set; the result contains only a masked preview such as abcdef...1234.
Privacy warning: this is convenient, but a Key sent to the Agent may remain in DSH conversation and tool-call history. Hidden terminal input is recommended for long-term personal use. If a Key was posted in chat, consider deleting that session or rotating the Key in the 88api.ai console afterward.
Choose and change the default model
Ask the agent in natural language:
List the available 88API image models.
Set my default image model to gemini-3.1-flash-image.
Generate a 16:9 product hero image with my default model.
Use gpt-image-2-4k for this image only; do not change my default.
Or set it from the terminal:
dsh plugin --profile web exec 88api-image set-default gemini-3-pro-image
The Agent may call set_default only when the user explicitly asks for a long-term change. Ordinary generations omit the model and use the saved default exactly.
Generation and editing
image_generate_88api accepts:
- one
prompt, optionally repeated with count from 1 to 4;
- or
prompts, up to 20 different sequential paid requests;
- an optional explicit
model for one call;
aspect and provider-valid resolution;- ordered local
reference_images, which change the route to image editing;
dry_run: true, which validates and prints sanitized request plans without a Key or paid request.
Image2 uses /v1/images/generations or /v1/images/edits. Nano Banana always uses /v1/chat/completions with modalities: ["text", "image"] and extra_body.google.image_config.
Generated files are saved under ~/Pictures/88api-image by default. If the active DSH model declares image input and an attachment service is mounted, the plugin also attaches the generated image to the tool result. Otherwise it returns the absolute saved path without injecting an image into a text-only model route.
Cost and retry safety
Each count or prompts item is an independent paid request. Batches run sequentially and stop on the first failure.
Errors marked [NO-AUTO-RETRY] mean the request was accepted or its cloud state is unknown. The plugin never automatically retries such a request or falls back to another model. Report the possible charge and wait for explicit user authorization before submitting a new paid request.
Security model
DSH plugins run as trusted local code in the Host process; capability metadata is not a sandbox. Review the source and pin a commit before installation. This plugin:
- keeps DSH core packages as peer dependencies to avoid duplicate Cordis/tool runtimes;
- stores the Key with restrictive file permissions where the platform supports them;
- masks the Key in all summaries;
- caps reference and response bytes;
- requires HTTPS for the API base URL unless a deployment explicitly opts into an insecure local test endpoint;
- refuses non-HTTPS, local, or private-network image URLs returned by an upstream response;
- does not send the Key to redirected or third-party image hosts.
Current scope
Version 0.1 focuses on unified text-to-image, multi-reference editing, repeated outputs, sequential prompt batches, dry runs, persistent model selection, and DSH attachment rendering. It does not yet port the older Codex-only SSE preview, folder/template workflow, repair-pass, or nail stress-test commands.
Development
npm install
npm run check
npm run self-test
The test suite uses only local mock servers and never calls a paid 88API endpoint. CI also packs the bundle, installs the tarball into a clean DSH profile, and verifies the composed config.
License: MIT.
