GPT Image by Ace Data Cloud for LangChain

Install langchain-gpt-image-acedatacloud to give a LangChain application typed GPT Image by Ace Data Cloud tools. This is an Ace-provided integration, not an official client of the service brand. It does not install the other four service modules. 中文 · Privacy.

1. Install

Intended official registry entry: PyPI langchain-gpt-image-acedatacloud. Publication and LangChain official listing are pending review; no marketplace listing is claimed. After publication:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install langchain-gpt-image-acedatacloud

For current PR preview: clone AceDataCloud/LangChain, then pip install -e packages/core -e packages/gpt-image.

Get the application API Key

1. Register or sign in → Applications. If no General application exists, choose Initialize General Application.
2. Open the General application. Copy its API Key, or choose Manage Keys → Create to make a separately named LangChain key. Review expiration, usage limitations and Allowed APIs. Allow both the generation and same-ID task query paths used below. Confirm service access, balance and current pricing. No trial allowance is promised.
3. Copy the raw token only, without Bearer , quotation marks or redacted characters. A platform-... account-management token cannot replace this application key.

These are real Ace console screenshots reused from SunoDify, retrieved 2026-10-18; later console layouts may differ. They show credential setup, not a LangChain GUI. Real tokens are redacted.

export ACEDATACLOUD_API_TOKEN='your application key'

PowerShell: $env:ACEDATACLOUD_API_TOKEN='your application key'. Keep the token in the environment or secret manager, never in a prompt or workflow export.

2. Put the key in the client, not in model arguments

from langchain_acedatacloud import AceAPIClient
from langchain_gpt_image_acedatacloud import GPTImageToolkit

# No network requests: instantiate tools and inspect their names/schemas.
kit = GPTImageToolkit(client=AceAPIClient())
tools = kit.get_tools()  # Query-only by default.
print([tool.name for tool in tools])

There is no service-provider selection GUI in this package. Supply these LangChain BaseTool objects to your application or agent. Screenshots of another host's plugin authorization are not instructions for this Python integration.

3. First use, then query the same ID

After reviewing current service prices and deliberately authorizing one generation:

kit = GPTImageToolkit(client=AceAPIClient(), include_generation=True)
generate, retrieve = kit.get_tools()
# This line submits one paid generation if you choose to run it:
submitted = generate.invoke({"prompt": "A gentle sunrise scene"})
task_id = submitted["task_id"]
# Query the original ID; never call generate again just to wait:
result = retrieve.invoke({"task_id": task_id})
print(result["status"], result["terminal"], result["media_urls"])

gpt_image_generate_image submits one asynchronous request to /openai/images/generations. gpt_image_retrieve_task calls /openai/tasks with action=retrieve and the original id. A pending result is normal. Query that ID later until terminal=true; then inspect success/failure and final media URLs. The example shape is illustrative, not an actual paid result. Advanced edit/extend actions are not exposed in this initial toolkit.

Troubleshooting and cost

401: raw Key or token environment; 403: permissions, balance, expiry, Allowed APIs and response details; 429: reduce concurrency. For pending or a timeout, inspect the same task before any new submission. No automatic retries or hidden polling are performed. Usage History owns actual Credits. Avoid printing credentials or sending them to a model.