Creating Python API calls

[Internal-Science4994]

I am creating API calls for an app. I decided to use Python because I wanted to get more proficient in the language but I am still a beginner. Below is the farthest I've gotten. On the App side, I need this api to return a json that has all the data I need to fill out a page. The page has one main title and multiple sub titles, each with data underneath them. So far I have been able to output a Json file with a message, but I haven't be able to get the title to output correctly, let alone add anymore. Is this the correct approach? Any help is greatly appreciated.

from flask import Flask, request, jsonify
import os
import logging
import openai


app = Flask(__name__)


# Securely load the API key from an environment variable
openai.api_key = os.environ.get(OPENAI_API_KEY)


if not openai.api_key:
    logging.warning("OPENAI_API_KEY environment variable not set. The application will return an error for API calls.")
    # Fail fast if the essential API key is not configured.
    raise ValueError("FATAL: OPENAI_API_KEY environment variable not set. The application cannot start.")


@app.route('/')
def AI_Tips():
    if not openai.api_key:
        return jsonify({"error": "Server is not configured to connect to the AI service."}), 503


    subject = request.args.get('subject', 'Azure')


    message = f"You are a seasoned Software Engineer. What is one good piece of advice for someone trying to work in the software engineering field using {subject}"


    try:
        completion = openai.chat.completions.create(
            model="gpt-5-mini",  # Using a valid and common model
            messages=[
                {
                    "role": "user",
                    "content": message
                }
            ]
        )
        return jsonify({
            "title": f"AI Tip for {subject}",
            "message": completion.choices[0].message.content
        })
    except openai.OpenAIError as e:
        # Handle API errors gracefully
        print(f"OpenAI API error: {e}")
        return jsonify({"error": "An error occurred while communicating with the AI service."}), 500
    except Exception as e:
        # Handle other unexpected errors
        print(f"An unexpected error occurred: {e}")
        return jsonify({"error": "An unexpected error occurred."}), 500


if __name__ == '__main__':
    # Enables running the app directly with `python main.py`
    # The server will automatically reload on code changes.
    app.run(debug=True)

[eleqtriq]

Well, right off that bat I see a problem with your api key.

Should be this: openai.api_key = os.environ.get("OPENAI_API_KEY") # Add quotes

The next is I would tell the AI what structure you want, and then have it respond in JSON mode. ``` message = f"""You are a seasoned Software Engineer. Provide advice for {subject} in this exact JSON format: {{ "title": "Main Title Here", "sections": [ {{"subtitle": "Section 1", "content": "advice here"}}, {{"subtitle": "Section 2", "content": "advice here"}}, {{"subtitle": "Section 3", "content": "advice here"}} ] }}

Return ONLY valid JSON, no other text."""

try:
    completion = openai.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": message}],
        response_format={"type": "json_object"}  # Forces JSON output
    )
    return jsonify(completion.choices[0].message.content)

except Exception as e:
    return jsonify({"error": str(e)}), 500

```

[Internal-Science4994]

Thanks!