Access Check List

This list is used to quickly identify key matters before and after accessing MoonNexAI API.

Preparation phase

Item	Check Contents
API Key	MoonNexAI API Key has been created and is saved only at the service end.
Base URL	MoonNexAI API domain name selected by view; OpenAI-compatible client confirmed need for /v1.
Model Permissions	Available models and capabilities for account have been identified.
Balance	account balances, amounts and task restrictions have been confirmed.
Address of callback	asynchronous tasks is ready for HTTPS callback address.

Development phase

Item	Check Contents
Authentication	Send Authorization: Bearer <MOONNEXAI_API_KEY> with every request.
Error Handling	400, 401, 402, 403, 429 and 5xx have been processed.
task Save	asynchronous tasks saves task_id, model name and business order ID after submission.
Active Query	task queries have been made and callback reliance on them has been avoided.
Wait for the Zen process.	callback Receptor End to task_id Dossing, etc.
media assets Reference	Separated the URL of the customer network, MoonNexAI hosting URL, model media assets ID and binary file for direct transmission.
Trace	Saved trace_id/ request_id for MoonNexAI returns, easy troubleshooting.

Self-measured before going online

1. Call GET /v1/models, confirm API Key available.
2. Submit a minimum request with the target model.
3. If asynchronous tasks, query to successful state and read the URL.
4. Simulate a failure request to confirm that the error code is recognized by the business system.
5. Simulates a duplicate callback to confirm that the order will not be created or issued again.
6. Check the log, confirm that there is no real API Key record.
7. Checks the front page and client package to confirm that API Key is not included.
8. When using the asset API, choose mode=oss or mode=asset according to the selected model. Use mode=both only when you need both a hosted URL and Asset://asset_xxx.
9. Confirms that mode=asset is not called if a model that does not support media assets references is used.

Recommended record field

field	Annotations
request_id	Business system request ID.
trace_id	MoonNexAI link ID.
task_id	MoonNexAI task ID.
model	Model used by request.
status	Current task status.
callback_url	Webhook URL.
created_at	task creation time.
completed_at	task completion time.
result_url	The successful outcome address.
result_url_policy	Result URL strategy, e.g., direct return, agent or transfer.
error_code	Error code when failed.

Relevant Pages

• Authentication
• Endpoint directory
• Asynchronous tasks
• Webhooks and callbacks
• Errors
• API Key Security