API Helper Reference

Fetches stock data from Finnhub's API. Given a ticker symbol (or ISIN/CUSIP), it can return a real-time quote snapshot, the company's profile, and key financial metrics. All three sections are returned by default; you can request only a subset. Quote data on the free tier may be delayed ~15 minutes during market hours.

On error: { "success": false, "error": "..." } with HTTP 400.

Searches multiple social platforms via the API Direct service. Despite the filename, it supports Twitter/X posts, Facebook posts, Reddit posts, and Reddit comments. Results are returned as a formatted text summary alongside the raw structured data. Up to 8 items per platform are included in the response.

Accepts a natural-language question, searches YouTube for up to 3 relevant videos, retrieves their transcripts (using multiple extraction strategies including the /youtubei/v1/get_panel API), and then feeds the transcripts to llm.php to synthesize a comprehensive answer. Only the transcript content is used — no external web search. The helper is rate limited as youtube and logs failures to api/youtube.log.

Returns an error if no videos are found, none have accessible transcripts, a dependency key is missing, or the helper hits its rate limit. GET also supports JSONP with callback or cb.

Returns the plain-text transcript for a public YouTube video using the same multi-strategy extraction logic used by youtube.php. Pass either an 11-character YouTube videoId or a full YouTube URL. The helper is rate limited as transcript and logs failures to api/transcript.log.

Returns an error if the video ID is invalid, no transcript can be retrieved, or the helper hits its rate limit.

Takes a plain-English description and uses Gemini to generate a complete, self-contained single-file HTML app optimized for mobile. The file goes through an iterative verification and improvement loop (up to 5 rounds) before being saved to the api/ directory as codeN.html. The public URL is returned in the response.

Generated apps can call web.php for live web data, llm.php for lightweight AI tasks, and image_gen.php for runtime image generation. A pre-generation image manifest (<!-- APP_GEN_PREGENERATE_IMAGES [...] -->) can also be embedded in the HTML to generate up to 30 static images at save time.

A Tavily search proxy designed to be called from browser apps for live, public web data. By default it extracts and returns the first numeric value from the search answer — ideal for stock prices, scores, rates, and similar. Set text=true to get a plain-text answer instead, with length optionally capped by max_sentences. An optional url parameter narrows results to a specific domain.

A secondary mode (mode=image_prompt_refine) passes the prompt to Gemini and returns an enhanced image generation prompt — useful for improving image_gen.php inputs.

Returns text/plain. With text=false (default): a plain number string like 189.34, or null if no number was found. With text=true: a plain-text answer. If the Tavily query is over 400 characters, it is truncated and the response appends Tool Error: Query truncated, max query length is 400 characters. On error: null with an appropriate HTTP status code.

Generates a PNG image from a text prompt using AIML's alibaba/z-image-turbo model. Returns the raw image bytes directly as image/png — use response.blob() and URL.createObjectURL() in browser apps. Portrait (3:4) by default; set landscape=1 for landscape (4:3) output. AIML's safety checker is off by default; opt in with safety_checker=1.

When called as a library function (require_once 'image_gen.php'), use generateImage($prompt, $isLandscape, $enableSafetyChecker) which returns the raw binary string, or run_image_gen($inputs) which saves the image to logi_image.png and returns a public URL.

On sites that block external fetch() but allow external images, such as newer free Neocities sites, set the helper URL directly as an image source instead of fetching a blob.

HTTP 200 with Content-Type: image/png and raw PNG bytes on success. On error: plain text error message with an appropriate HTTP error code.

Generates a new image from text, or edits an existing input image, by forwarding the request to Adam's local Z-Image-Turbo server. This helper is shaped like image_gen_gemini.php: it is CORS-open, accepts GET or POST, supports prompt or q, accepts optional base64/data-URI images or multipart uploads, and returns raw image bytes.

The public proxy depends on the local Z-Image server being online and reachable through the router port forward to 73.241.203.94:3477.

HTTP 200 with Content-Type: image/png and raw PNG bytes on success. On error: plain text message with an appropriate HTTP status code.

Generates images using Gemini's gemini-3.1-flash-image-preview model and returns raw image bytes. Uniquely, it supports passing an existing input image to enable image editing or style transfer — send the image as base64 (with or without a data URI prefix) in the image parameter, or as a multipart file upload. Portrait (3:4) is the default; landscape (4:3) can be requested.

On sites that block external fetch() but allow external images, such as newer free Neocities sites, set the helper URL directly as an image source instead of fetching a blob.

HTTP 200 with the detected MIME type (image/png, image/jpeg, etc.) and raw image bytes. On error: plain text message with appropriate HTTP status code.

Generates images with ByteDance Seedream v4 through AIML. With no input image it uses bytedance/seedream-v4-text-to-image. If you provide one or more input images, it uses bytedance/seedream-v4-edit with image_urls. It returns raw image bytes like image_gen_gemini.php.

HTTP 200 with the detected image MIME type and raw image bytes. On error: plain text message with an appropriate HTTP status code.

Looks up a Steam game by name, resolves its App ID via the Steam store search API, then fetches either user reviews or community discussion search results. If the game name fails to resolve, the helper returns alternative search term suggestions and retry strategies. Discussion results are extracted from HTML and returned as a plain-text summary (up to 3000 words).

A thin proxy to DeepSeek via the AIML chat completions API. The default model is deepseek/deepseek-v4-flash; pass model=pro to use deepseek/deepseek-v4-pro. Passing model=lite, omitting model, or using any other value keeps the default flash model. Responses are uncapped by default; pass max_sentences to add sentence-limit guidance. Suitable for translations, classifications, rewrites, summaries, extractions, trivia lookups, and simple puzzles. For live web data use web.php instead.

Returns text/plain — no JSON wrapper — so it can be used directly in browser fetch() calls with response.text(). If you pass callback or cb on a GET request, it returns JSONP as application/javascript: callback({ ok: true, text: "..." }). JSONP responses use Cache-Control: no-store.

text/plain with the model's answer. On error: plain error string with appropriate HTTP status. In JSONP mode, the response is always JavaScript with { ok, text } or { ok: false, error, status }.

A thin proxy to Grok chat completions, including multimodal prompts with image uploads. It uses xAI directly when grok_key.txt is available. The default model is grok-4.3; pass model=lite or model=grok-4-1-fast-non-reasoning to use the lite model. Text-only responses are uncapped by default; pass max_sentences to add sentence-limit guidance. Suitable for conversational text tasks, image-aware questions, and app chat flows.

Returns text/plain with no JSON wrapper, so browser apps can call it directly with response.text(). If you pass callback or cb on a GET request, it returns JSONP as application/javascript: callback({ ok: true, text: "..." }). Use this mode for newer free Neocities sites, where external fetch() is blocked by Content Security Policy.

text/plain with the model's answer. On error: plain error string with appropriate HTTP status. In JSONP mode, the response is always JavaScript with { ok, text } or { ok: false, error, status }.

A thin proxy to Gemini. The default model is gemini-3-flash-preview; pass model=lite or model=gemini-3.1-flash-lite to use gemini-3.1-flash-lite. It supports simple text prompts, structured Gemini contents or parts, optional image input, system prompts, and generation configuration.

This helper is for general Gemini text, vision, and audio/content requests. It does not accept Gemini File Search tools; use rag.php for File Search / RAG queries against a document store.

Like llm.php, the response is text/plain with no JSON wrapper. If you pass callback or cb on a GET request, it returns JSONP as application/javascript for Neocities/free-CSP pages.

text/plain with the model's answer. Returns null (the literal string) on API-level errors, or an HTTP error code on input validation failures. In JSONP mode, the response is always JavaScript with { ok, text } or { ok: false, error, status }.

Asks a question against a Gemini File Search store and returns a short answer grounded in that store's documents. The helper uses gemini-2.5-flash, automatically adds a briefness hint to the prompt, enforces the shared rag rate limit, and logs failures to api/rag.log.

Use this when an app needs answers from a specific uploaded document corpus instead of open-web search or a general chat model. The caller must provide the File Search store name or ID in store_id. Optional voice fields let a browser send microphone audio together with an instruction prompt.

On error: { "success": false, "error": "...", "code": 400 } or another relevant HTTP status. Rate-limit failures return HTTP 429 and may include a Retry-After header.

Transcribes spoken audio into plain text using Gemini (gemini-3.1-flash-lite-preview). It is designed for browser microphone recordings from MediaRecorder, but also accepts base64 audio in JSON or form posts. The helper is rate limited as transcribe.

Returns text/plain with no JSON wrapper. If there is no intelligible speech, Gemini is instructed to return null.

text/plain transcript text. On input errors, returns a plain error string with HTTP 400. On Gemini/API failure, returns null with HTTP 502.

Sends a plain-text email through Hostinger's SMTP server using PHPMailer. The From address is always adam@promptbox.cn (PromptBox); an optional custom sender is set as the Reply-To header instead. All three of recipient, subject, and body are required.

Converts text to speech using OpenAI tts-1 and streams MP3 audio. The helper strips HTML, markdown syntax, and control characters before synthesis, enforces the shared tts rate limit, and reads the OpenAI key server-side from openai_key.txt.

HTTP 200 with raw MP3 bytes and Content-Type: audio/mpeg. On error: JSON { "success": false, "error": "..." } with an appropriate HTTP status.

Converts text to speech using AIMLAPI's Inworld inworld/tts-1 model and streams the generated audio file. HTML tags, markdown syntax, and control characters are automatically stripped from the input before synthesis. Maximum input length is 500000 characters.

tts_inworld_test.html lets you enter a prompt, choose an Inworld voice, and play the generated audio in the browser.

Allowed Inworld voices: Alex, Ashley (default), Craig, Deborah, Dennis, Dominus, Edward, Elizabeth, Hades, Heitor, Julia, Maite, Maitê, Mark, Olivia, Pixie, Priya, Ronald, Sarah, Shaun, Theodore, Timothy, Wendy.

HTTP 200 with raw audio bytes on success. The response uses Content-Type: audio/mpeg for MP3 and audio/wav for WAV. On error: JSON { "success": false, "error": "..." } with appropriate HTTP status.

These files are live HTTP endpoints, but they are support tools rather than reusable app-generation helpers. They are included here so the reference matches the actual folder.

Provides rolling-window rate limiting for the public helpers. Unknown programs default to 300 requests per 24-hour window. An optional hourly sub-limit can also be configured.

Can also be called directly as an HTTP API to check or record usage for any program name, and includes an admin dashboard (password-protected) for monitoring and adjusting limits.

The Retry-After HTTP header is also set when denied.

Visit rate-limit.php?password=pppp0000 in a browser to view all registered programs, their usage bars, last-used times, and controls for adjusting limits, resetting usage, or deleting program records.