Fíordheimhniú, Eochracha API, agus Eagrú
Ar an leathanach seo
Fíordheimhniú, Eochracha API, agus Eagrú
Sula scríobhann tú aon líne cóid, caithfidh tú do rochtain API a chumrú. Clúdaíonn an ceacht seo cruthú eochracha, struchtúrú rochtana trí eagraíochtaí agus tionscadail, agus na réamhchúraimí slándála a choscann an tubaiste chlasaiceach: eochair a bhrú go hearráideach chuig stór poiblí áit a n-ídíonn strainséir í thar oíche.
Cruthaigh do Chuntas agus Faigh Eochair
Tógann an próiseas trí chéim. Ar dtús, téigh go platform.openai.com agus cruthaigh cuntas; gheobhaidh tú creidmheasanna saor in aisce go huathoibríoch chun turgnamh a dhéanamh. Ina dhiaidh sin, téigh go dtí an roinn API Keys ar an deasc rialaithe agus gineann eochair nua. Ní fheicfidh tú an eochair seo ach uair amháin: cóipeáil í láithreach, ach ná greamaigh í isteach i do chód.
# Your API key looks like this (never share it!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Best practice: use an environment variable
import os
api_key = os.environ.get("OPENAI_API_KEY")
Is é an tríú céim an athróg timpeallachta a dhearbhú, rud a bhraitheann ar do hardán. Ar mheaisín forbartha, is minic gurb é comhad .env a lódáiltear le python-dotenv an bealach is áisiúla. Ar fhreastalaí, is fearr athróg timpeallachta a shainíonn d’eagraitheoir nó do sheirbhís rúnda.
# Linux / macOS — add to ~/.bashrc or ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# .env file (with python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Cén Cineál Eochrach le Roghnú
Tá eochracha tionscadail, atá inaitheanta trína réimír sk-proj-, nasctha le tionscadal sonrach agus tairgeann siad an rialú is fearr. Úsáidfidh tú iad seo i ngach cás beagnach. Brathann an SDK orthu go huathoibríoch nuair a shocraítear an athróg timpeallachta, rud a fhágann go ndéanann OpenAI() samplú gan argóintí i ngach sampla sa chúrsa seo.
from openai import OpenAI
# The SDK automatically detects OPENAI_API_KEY
client = OpenAI()
# Or specify explicitly (not recommended for production)
client = OpenAI(api_key="sk-proj-...")
Is iad eochracha seirbhíse an dara cineál. Deartha d’fheidhmchláir fhreastalaí a éilíonn rochtain ardaithe, tugann siad ceadanna breise agus mar sin éilíonn siad cúram breise: stóráil iad i stór rúnda agus ná scaip a luach riamh chuig stáisiún oibre forbartha.
Eagrúcháin agus Tionscadail
Tá an rochtain struchtúrtha ar thrí leibhéal neadaithe:
- Eagraíocht: Do chuideachta nó do fhoireann
- Tionscadal: Grúpáil loighciúil (m.sh. “Chatbot Táirgeachta”, “Anailís Sonraí”)
- Eochair API: Nasctha le tionscadal sonrach
Má bhaineann tú le heagraíochtaí iolracha, sonraigh an ceann atá beartaithe agat a úsáid agus tú ag déanamh samplú den chliaint:
from openai import OpenAI
# Specify the organization (useful if you belong to multiple)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Tóg an t-am chun do úsáid a roinnt ina tionscadail seachas gach rud a ródú trí eochair amháin. Feicfidh tú an tairbhe ag an gcéad chomhartha trioblóide. Tá a rianú úsáide féin ag gach tionscadal, rud a ligeann duit costais a chur i leith gné sonrach seachas iomlán míosúil doiléir. Tá teorainneacha ráta scartha freisin: ní chuirfidh post baisce oíche a sháithíonn a chuóta cosc ar do chatbot freagairt do chustaiméirí. Is féidir leat baill éagsúla a shannadh do gach tionscadal ansin, agus rud atá ríthábhachtach, eochair chompromáide a chúlghairm gan cur isteach ar fheidhmchláir eile.
Ná Nocht Do Chuid Eochracha Riamh
Tá an riail simplí agus absalóideach: ní fheictear eochair riamh i gcód foinse. Labhraíonn an chodarsnacht idir an dá blúire thíos níos airde ná léacht fhada.
# BAD — hardcoded key in code
client = OpenAI(api_key="sk-proj-abc123") # DANGER!
# GOOD — environment variable
client = OpenAI() # Automatically reads OPENAI_API_KEY
# GOOD — .env file with python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Baineann an toradh le do .gitignore, a chaithfidh comhaid chumraíochta áitiúla a eisiamh roimh do chéad ghealladh, ní ina dhiaidh. Fanann eochair a fhoilsítear agus a scriostar ina dhiaidh sin i stair an stórais.
# ALWAYS add these lines to your .gitignore
.env
.env.local
.env.production
*.key
Ar deireadh, pleanáil rothlú rialta, gach 90 lá. Is féidir leat é seo a dhéanamh gan am stad: cruthaigh eochair nua, nuashonraigh do imlonnúcháin, agus ansin scrios an sean-cheann ach amháin nuair nach bhfuil aon rud á húsáid aige a thuilleadh.
Fíoraigh do Chumrúchán
Sula dtéann tú ar aghaidh, rith an script seo. Seiceálann sí láithreacht na heochrach, taispeánann leagan giorraithe chun a dheimhniú gurb í an ceann ceart í, agus déanann glaonna fíor ansin. Athruit an tástáil seo gach uair a oibríonn timpeallacht go strange.
from openai import OpenAI
import os
def verify_configuration():
"""Verify that the API configuration is correct."""
# Check for the key
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("ERROR: OPENAI_API_KEY not defined")
return False
print(f"Key detected: {api_key[:8]}...{api_key[-4:]}")
# Test the connection
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Connection successful: {response.output_text}")
return True
except Exception as e:
print(f"Connection ERROR: {e}")
return False
verify_configuration()
# Expected result:
# Key detected: sk-proj-...xxxx
# Connection successful: OK
Príomhphointí
- Úsáid eochracha tionscadail (
sk-proj-...) do gach feidhmchlár - Stóráil do chuid eochracha in athróga timpeallachta, riamh i gcód
- Eagraigh do rochtain leis an hierarchaíocht Eagraíocht → Tionscadal → Eochair
- Déan rothlú rialta ar do chuid eochracha (gach 90 lá)
- Cuir
.envle do.gitignorei gcónaí